A clean, minimal starter to build authenticated apps with:

• Next.js (App Router)
• Clerk (Authentication)
• Convex (Backend + Database)

Includes protected routes, automatic user sync, and a solid foundation to start building real apps.

• 🔐 Authentication with Clerk
• 🧱 Convex backend with schema & functions
• 🔄 Automatic user sync (Clerk → Convex)
• 🛡️ Route protection via middleware
• 🎯 Clean app structure (auth vs app separation)
• ⚡ Minimal, production-ready UI
• 🧪 Ready for queries & mutations

.
├── convex/              # Convex backend (schema, functions)
├── src/
│   ├── app/
│   │   ├── (auth)/      # Sign-in / Sign-up
│   │   ├── (app)/       # Protected routes (dashboard)
│   │   ├── globals.css  # Global css file
│   │   └── page.tsx     # Public landing page
│   ├── components/
│   │   ├── providers/   # Convex provider
│   │   └── shared/      # UserSync.ts
│   └── middleware.ts    # Clerk route protection
├── .env.example
└── README.md

Before getting started, make sure you have the following:

• Node.js v18 or higher
• A Clerk account with an application set up
• A Convex account with a project created

git clone https://github.com/harsh661/nextjs-clerk-convex-starter.git
cd nextjs-clerk-convex-starter

npm install

cp .env.example .env.local

Then fill in .env.local:

# Convex
CONVEX_DEPLOYMENT=
NEXT_PUBLIC_CONVEX_URL=
NEXT_PUBLIC_CONVEX_SITE_URL=

# Clerk
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=

NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up

NEXT_PUBLIC_CLERK_SIGN_IN_FORCE_REDIRECT_URL=/dashboard
NEXT_PUBLIC_CLERK_SIGN_UP_FORCE_REDIRECT_URL=/dashboard

NEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/
NEXT_PUBLIC_CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/

⚠️ Important — Convex + Clerk Integration

In your Convex Dashboard → Settings → Environment Variables, add:

CLERK_JWT_ISSUER_DOMAIN=https://your-clerk-domain.clerk.accounts.dev

npx convex dev

npm run dev

Visit → http://localhost:3000

Route protection is handled in middleware.ts.

Users are automatically synced to Convex on sign-in. No manual setup required.

MIT