Boilerplate built for AI coding agents, tools, CLI

Codeguide Starter Fullstack

A modern web application starter template built with Next.js 15, featuring authentication, database integration, and dark mode support.

Tech Stack

• Framework: Next.js 15 (App Router with Turbopack)
• Language: TypeScript
• Authentication: Better Auth
• Database: Drizzle ORM with PostgreSQL
• Styling: Tailwind CSS v4
• UI Components: shadcn/ui (New York style)
• Theme System: next-themes
• Icons: Lucide React

Prerequisites

Before you begin, ensure you have the following:

• Node.js 18+ installed
• Docker and Docker Compose (for database setup)
• Generated project documents from CodeGuide for best development experience

Getting Started

1. Clone the repository

   git clone <repository-url>
   cd codeguide-starter-fullstack
   

2. Install dependencies

   npm install
   # or
   yarn install
   # or
   pnpm install
   

3. Environment Variables Setup

   • Copy the .env.example file to .env:

     cp .env.example .env
     

   • The default values work with Docker setup, modify as needed

4. Start the development server

   npm run dev
   # or
   yarn dev
   # or
   pnpm dev
   

5. Open http://localhost:3000 with your browser to see the result.

Configuration

Option 1: Docker Setup (Recommended)

1. Start PostgreSQL with Docker:

   npm run db:up
   

   This starts PostgreSQL in a Docker container with default credentials.

2. Push database schema:

   npm run db:push
   

Option 2: Local Database Setup

1. Create a PostgreSQL database locally
2. Update your environment variables in .env:

   DATABASE_URL=postgre