AGENTS.md

For detailed documentation about this repository, see REPO.md.

Development Guidelines

Code Style

• Run bun run lint before committing - this uses Biome for linting
• Run bun run format to format code with Biome
• Do NOT add comments to code unless explicitly requested
• Follow existing code patterns and conventions

Commands

• bun run dev - Start development server with Turbopack
• bun run build - Build for production
• bun run lint - Run Biome linter (check code)
• bun run format - Format code with Biome
• bun run deploy - Deploy to Cloudflare Workers

Tech Stack Notes

• Next.js 15 with App Router
• React 19
• TypeScript throughout
• Convex for backend (queries in convex/ directory)
• Clerk for authentication (use useConvexAuth() hook, not Clerk's useAuth())
• shadcn/ui components in components/shadcn/
• Radix UI imports use pattern: import { ComponentName as Primitive } from "radix-ui"
• Zod for validation

Project Structure

• app/ - Next.js pages (App Router)
• components/ - Reusable React components
• convex/ - Backend functions and schema
• actions/ - Server Actions
• utils/ - Utility functions

Important

• Never commit secrets or API keys
• Always test changes before committing
• Use Authenticated, Unauthenticated, AuthLoading from Convex, not Clerk
• All Convex functions must check ctx.auth.getUserIdentity()