A production-ready Next.js template with authentication, database, and all the essentials pre-configured.

1. Click "Use this template" on GitHub
2. Clone your new repo
3. Run setup:

npm run setup

git clone https://github.com/yourusername/nextjs-template.git my-app
cd my-app
npm run setup

If you prefer manual setup:

# Install dependencies
npm install

# Copy environment variables
cp .env.example .env.local

# Generate NextAuth secret
openssl rand -base64 32
# Add output to NEXTAUTH_SECRET in .env.local

# Initialize Convex
npx convex dev
# Copy the URL to NEXT_PUBLIC_CONVEX_URL in .env.local

# Setup Husky
npx husky init
echo "npx lint-staged" > .husky/pre-commit

# Run both Convex and Next.js
npm run dev

# Or run separately
npm run dev:convex  # Terminal 1
npm run dev:next    # Terminal 2

Open http://localhost:3000

Copy .env.example to .env.local and fill in:

├── convex/                 # Convex backend
│   ├── schema.ts          # Database schema
│   └── users.ts           # User queries/mutations
├── src/
│   ├── app/
│   │   ├── (auth)/        # Auth pages (login, register)
│   │   ├── (dashboard)/   # Protected pages
│   │   ├── api/           # API routes
│   │   └── ...
│   ├── components/
│   │   ├── ui/            # shadcn components
│   │   ├── layout/        # Header, Sidebar, etc.
│   │   └── features/      # Feature components
│   ├── hooks/             # Custom React hooks
│   ├── lib/               # Utilities
│   └── types/             # TypeScript types
├── scripts/
│   └── setup.mjs          # Setup wizard
└── ...

• Email/password authentication
• GitHub OAuth (optional)
• Protected routes via proxy.ts
• Session management with NextAuth.js

• Convex for real-time data
• Type-safe queries and mutations
• Automatic TypeScript generation

• shadcn/ui components pre-installed
• Dark mode support
• Responsive sidebar layout
• Toast notifications

1. Go to GitHub Developer Settings
2. Create a new OAuth App
3. Set callback URL to http://localhost:3000/api/auth/callback/github
4. Add GITHUB_ID and GITHUB_SECRET to .env.local

1. Go to Google Cloud Console
2. Create OAuth 2.0 credentials
3. Add authorized redirect URI: http://localhost:3000/api/auth/callback/google
4. Add provider to src/app/api/auth/[...nextauth]/route.ts

1. Push to GitHub
2. Import to Vercel
3. Add environment variables
4. Deploy

npx convex deploy

MIT