vibe-coding-template

# Full Stack Vibe Coding Template

A modern, modular full-stack application starter template with NextJS frontend and Python FastAPI backend, supabase backend for Vibe coding.

Contains all the common boilerplate features. Just add the README.md and CONTEXT.md files to AI coding agent's context.

Dont waste your time and tokens on boilerplate code. Use it to build your app

## 🤖 AI-Powered Development

This template includes comprehensive **Cursor Rules** and **Agent Instructions** to supercharge your AI-assisted development:

### Cursor Rules (`.cursor/rules/`)
- **Context-aware guidance** that automatically applies based on the files you're editing
- **Template system** with production-ready code patterns (`@api-endpoint-template`, `@react-component-template`)
- **Best practices enforcement** for FastAPI, Next.js, Supabase, and LLM integration
- **Automatic rule application** - no manual setup required

### AGENTS.md
- **Simplified instructions** for AI coding assistants
- **Project patterns** and common code examples
- **Architecture overview** and development standards
- **Quick reference** for established patterns

### Benefits
- ⚡ **Faster Development** - Templates and patterns accelerate coding
- 🎯 **Consistency** - All code follows established patterns
- 🛡️ **Quality** - Built-in best practices and error handling
- 📚 **Learning** - New developers quickly understand project structure
- 🤖 **AI-Optimized** - Designed specifically for AI coding assistants

## Features

### Backend (Python FastAPI)
- **FastAPI REST API** - Fast, type-checked API development
- **Supabase Integration**
  - Authentication (Google, LinkedIn, Email/Password)
  - Database connectivity
  - Realtime subscriptions
  - Storage management
  - Database migrations
- **LLM Integration**
  - OpenAI and Cursor support
  - Abstracted LLM service
  - Vector embeddings service
- **Vector Database**
  - Qdrant integration
  - Document storage and semantic search
  - Automatic fallback to local