Development

Run the Cora Next.js app from the repository root, and preview this Mintlify documentation site from the docs/ folder.

Technology stack

Next.js, Supabase, Cloudflare (Turnstile + R2), Google Maps, Twilio via Supabase SMS, Vercel, and more — how each is used in the repo.

Cora web application (Next.js)

The product UI is a Next.js 16 app at the repository root (not inside docs/).

Prerequisites: Node.js 20+ (matches package.json engines if set), npm or pnpm, and a Supabase project for auth and data.

1. Install dependencies

   npm install
   
2. Configure environment variables

   Create .env.local in the repo root (see the root README.md for the minimum set). Typical keys include:

   • NEXT_PUBLIC_SUPABASE_URL — Supabase project URL
   • NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY — anon / publishable key
   • NEXT_PUBLIC_HOME_PAGE — full origin used by server actions that call internal APIs (e.g. http://localhost:3000 in dev)
   • NEXT_PUBLIC_GOOGLE_MAPS_API_KEY — interactive map
   • NEXT_PUBLIC_TURNSTILE_SITE_KEY — login / signup when enabled
   • R2 / S3 variables for media uploads (S3_ENDPOINT, S3_KEY_ID, S3_SECRET_KEY) when using the bundled upload routes

   Never commit .env.local to git.

3. Start the dev server

   npm run dev
   

   Open http://localhost:3000. Auth and middleware use the Supabase SSR client under src/lib/supabase/.

Preview this documentation site

These pages are built with Mintlify. Configuration and branding for the docs only live in docs/docs.json (colors, fonts, name, description, navigation).

1. Install the Mintlify CLI

   npm i -g mint
   
2. Run from the docs directory

   cd docs
   mint dev
   

   By default the preview listens on port 3000. If the Cora app is already using 3000, use e.g. mint dev --port 3333.

Validate links (optional)

cd docs
mint broken-links

Mintlify troubleshooting

If the CLI fails (for example Sharp / native module issues on Apple Silicon), see Mintlify’s CLI docs or remove ~/.mintlify and reinstall the CLI as described in their troubleshooting guide.