Developer Documentation
Welcome to the Village Data developer documentation. This guide covers architecture, setup, and API reference for building and deploying the platform.
Architecture Overview
| Component | Platform | Purpose |
|---|---|---|
| UI (Next.js) | Vercel | Frontend application |
| API Server | Digital Ocean | Backend API |
| MCP Server | Digital Ocean | Model Context Protocol server |
| Database | Supabase | PostgreSQL + Auth |
Quick Links
- Local Development - Set up your development environment
- Environment Variables - Required configuration
- Database Schema - Data model reference
- API Reference - Endpoint documentation
Tech Stack
Frontend
- Next.js 14 - React framework with App Router
- Mantine - UI component library
- TypeScript - Type-safe development
Backend
- Supabase - PostgreSQL database + authentication
- FastMCP - Model Context Protocol server
- OpenAI/Google AI - LLM providers
Infrastructure
- Vercel - Frontend hosting
- Digital Ocean App Platform - Backend services
- Supabase Cloud - Managed database
Getting Started
- Clone the repository
- Install dependencies with
pnpm install - Set up environment variables
- Start local Supabase with
supabase start - Run the development server with
pnpm dev
See Local Development for detailed instructions.