my-app/
├── CUBBY.md          # AI context file
├── cubby.yaml        # Platform config
├── package.json
└── ...

## Stack

- Next.js 16 (App Router, Turbopack)
- Prisma ORM + SQLite (default; Neon Postgres on Builder/Pro)
- Docker container deployment

## Project Structure

app/
  api/           -- API routes (server-only)
  page.tsx       -- Pages (server components by default)
lib/
  db.ts          -- Prisma client singleton
prisma/
  schema.prisma  -- Database schema

## CLI Commands

cubby dev          # Local development with hot reload
cubby deploy       # Build and deploy to production
cubby secrets set  # Manage environment variables

## Platform Constraints

### Environment Variables
- PORT -- Provided by runtime (default: 3000). Do not hardcode.
- DATABASE_URL -- Provisioned automatically. Never commit to repo.
- Use `cubby secrets` for production secrets, not .env files.

### Build Requirements
- next.config.ts must have output: "standalone" for Docker builds

## Authentication

Cubby handles authentication via platform SSO. Your app does NOT need its own auth system.

- Users authenticate once through the Cubby platform
- Authenticated user identity is passed via request headers
- Do not install auth libraries (NextAuth, Clerk, etc.)

## Forbidden Patterns

- Do not use middleware.ts -- renamed to proxy.ts in Next.js 16
- Do not hardcode DATABASE_URL or commit .env files
- Do not install auth libraries -- Cubby SSO handles authentication
- Do not use prisma migrate dev in production

# My Todo App

A task management app with AI-powered suggestions.

## Custom Models

model Todo {
  id        String  @id
  title     String
  priority  Int     # 1 = high, 2 = medium, 3 = low
  userId    String  # Owner's Cubby user ID
}

## API Routes

- POST /api/todos - Create a new todo
- GET /api/todos - List user's todos
- PUT /api/todos/[id] - Update a todo
- DELETE /api/todos/[id] - Delete a todo

## Business Logic

- Users can only see their own todos (filter by userId)
- High priority todos appear first
- Completed todos move to bottom of list