Full-Stack Starter Kit

    Connect Your StackIn Just 7 Commands

    A seamless full-stack setup with FastAPI/PostgreSQL backend and Next.js frontend that just works. Clone, connect, and create - without the configuration headache.

    View on GitHub

    Everything You Need

    A carefully crafted development environment that connects all the pieces of your stack

    Quick Setup

    Get up and running in minutes with just 6 simple commands. No complex configuration required.

    Developer Friendly

    Optimized developer experience with hot reloading and intuitive project structure.

    PostgreSQL Integration

    Ready-to-use database setup with migrations, models, and secure connections.

    Modern Stack

    Built with Next.js frontend and FastAPI backend using current best practices.

    API Auto-Documentation

    Automatic Swagger documentation for your API endpoints.

    Seamless Connection

    Pre-configured API client for hassle-free frontend-backend communication.

    Two Repositories, One Seamless Connection

    Each repository is powerful on its own, but together they create a perfect development environment.

    Backend Repository

    FastAPI + PostgreSQL backend with automatic Swagger documentation, database migrations, and Docker setup.

    full-stack-starter-backend→

    Frontend Repository

    Next.js frontend with TypeScript, pre-configured API client, and responsive design components.

    full-stack-starter-frontend→
    Just 7 Commands

    Up and Running in Minutes

    Start developing your full-stack application immediately with these simple steps. No complex setup required.

    Prerequisites

    • Docker and Docker Compose
    • Python 3.8+ with pip
    • Node.js 16+ with npm
    • Git

    Important Note

    Don't forget to copy the example .env file in the backend repo to configure your environment settings.

    1
    git clone https://github.com/Bradd3rs/full-stack-starter-backend.git

    Clone the backend repository to your local machine.

    2
    cd full-stack-starter-backend

    Navigate to the backend directory.

    3
    pip install -r requirements.txt

    Install Python dependencies for the backend.

    4
    docker-compose up -d

    Start the PostgreSQL database with Docker.

    5
    alembic upgrade head

    Run database migrations to set up the schema.

    6
    git clone https://github.com/Bradd3rs/full-stack-starter-frontend.git

    Clone the frontend repository to your local machine.

    7
    cd full-stack-starter-frontend && npm install && npm run dev

    Install the frontend dependencies and start the Next.js development server.