Bilal's Boilerplate
Full-Stack Boilerplate for Future Projects
Frontend, backend, database, authentication, and protected app scaffolding in one place so you can spin up new websites faster.
Frontend
Landing pages, dashboards, forms, and reusable UI components
Backend
Next.js route handlers ready for custom APIs and business logic
Authentication
Better Auth with Google OAuth integration
Database
Drizzle ORM with PostgreSQL for app data and auth tables
Setup checklist
0/4 completed
- Database URL resolvedPOSTGRES_URL configured explicitly.
- Database connected & schema
- Auth secret ready
- Google OAuth configured (optional)Add GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET to enable Google sign-in.
Next Steps
1. Set up environment variables
Copy .env.example to .env.local and configure what you need for this project:
- POSTGRES_URL if you are not using the local Docker database
- GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET for sign-in
- BETTER_AUTH_SECRET for a real auth signing secret
2. Set up your database
Start local Postgres and apply the committed baseline migration:
npm run db:upnpm run db:migrate3. Explore protected pages
4. Start building
Replace the starter copy, add your own data models and API routes, and extend the user/admin panels to match your product.