fastapi-full-stack-launch 1.1.0

A CLI tool to scaffold full-stack projects with FastAPI backend and React Vite frontend

🚀 FastAPI Full Stack Launch

A powerful CLI tool to scaffold production-ready full-stack projects with FastAPI backend and React + Vite + TypeScript frontend.

✨ Features

• 📁 Full-Stack Project Structure - Backend, frontend, and API proxy in one command

• ⚡ Fast Setup - Uses uv for lightning-fast Python package management

• ⚛️ Modern Frontend - React 18 + TypeScript + Vite

• 🐍 Production Backend - FastAPI with proper project structure

• 🔧 Pre-configured Components:

  • Backend (FastAPI):
    • RESTful API Router (v1)
    • CORS configured for frontend
    • Environment config with python-dotenv
    • SQLAlchemy + MySQL Database Setup
    • Testing Framework
  • Frontend (React + Vite):
    • TypeScript configured
    • ESLint setup
    • Hot Module Replacement

📋 Prerequisites

Requirement	Version	Installation
Python	3.8+	python.org
Node.js	18+	nodejs.org
uv	Latest	See Installing uv

📦 Installation

Windows:

pip install fastapi-full-stack-launch

macOS / Linux:

pip3 install fastapi-full-stack-launch

🛠️ Usage

Create a new full-stack project:

fastapi-full-stack-launch project <project_name>

Example:

fastapi-full-stack-launch project my-awesome-app

This generates a complete project structure:

my-awesome-app/
├── .venv/                    # Python virtual environment
├── backend/                  # Backend (FastAPI)
│   └── app/
│       ├── api/v1/
│       │   └── router.py
│       ├── core/
│       │   ├── config.py
│       │   └── logging.py
│       ├── db/
│       │   └── database.py
│       ├── models/
│       ├── schemas/
│       ├── services/
│       ├── tests/
│       ├── utils/
│       └── main.py
├── frontend/                 # Frontend (React + Vite + TypeScript)
│   ├── src/
│   ├── public/
│   ├── package.json
│   ├── vite.config.ts
│   ├── tsconfig.json
│   └── index.html
├── .env                      # Environment configuration
├── .gitignore
├── pyproject.toml
└── README.md

🚀 Quick Start

After creating your project:

Start the Backend:

macOS / Linux:

cd my-awesome-app
source .venv/bin/activate
cd backend
uvicorn app.main:app --reload

Windows:

cd my-awesome-app
.venv\Scripts\activate
cd backend
uvicorn app.main:app --reload

Backend runs at: http://localhost:8000 API Docs: http://localhost:8000/docs

Start the Frontend:

cd my-awesome-app/frontend
npm run dev

Frontend runs at: http://localhost:5173

⚙️ Environment Configuration

The .env file in your project root contains:

FASTAPI_APP_URL=http://localhost:8000
DATABASE_URL=mysql+pymysql://root:password@localhost:3306/my-awesome-app_db
FRONTEND_URL=http://localhost:5173

📥 Installing uv

uv is required for backend scaffolding. Install it using:

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

irm https://astral.sh/uv/install.ps1 | iex

📄 License

MIT License - see LICENSE for details.

---

Made with ❤️ by Krishi Devani