StackGen

A powerful CLI tool that generates production-ready, AI-friendly project scaffolds tailored to your tech stack preferences.

Go from idea to production-ready codebase in under 2 minutes.

Features

• 🚀 Production-Ready: Generates clean, scalable codebases with best practices baked in
• 🤖 AI-Friendly: Includes LLM skills files for easy AI-assisted development
• 🔧 Modular Architecture: Support for multiple tech stacks without hardcoded templates
• 🐳 Docker Support: Optional containerized development environment
• 🔐 Security First: Built-in security best practices and environment configuration
• 📦 Multiple Stacks: React + Node/Express, Python/FastAPI + React, and more

Installation

Via NPM (Recommended)

# Install globally
npm install -g @whyujjwal/stackgen

# Or use directly with npx
npx @whyujjwal/stackgen init my-project

Via Curl (One-liner)

curl -fsSL https://raw.githubusercontent.com/whyujjwal/stackgen/main/install.sh | bash

Build from Source

git clone https://github.com/whyujjwal/stackgen
cd stackgen
make build
sudo make install

Usage

# Interactive mode
scaffold init

# Specify project name
scaffold init my-project

# Skip prompts with flags
scaffold init my-project --stack=react-node --db=postgresql --docker

Supported Stacks

• React + Node/Express: Full-stack JavaScript with modern tooling
• Python/FastAPI + React: FastAPI backend with React frontend
• More coming soon!

Why This Tool?

🚀 Start Fast, Scale Forever

Stop wasting hours on boilerplate. Go from idea to production-ready codebase in under 2 minutes. No more copy-pasting from old projects or fighting with configuration.

🏗️ Built for Scale, Not Demos

Unlike other scaffolding tools that generate toy projects, this creates production-grade architecture:

• Proper separation of concerns
• Security best practices (CORS, helmet, JWT, password hashing)
• Environment-based configuration
• Database migrations ready
• Testing infrastructure included
• Docker-ready deployments

🤖 AI-First Development

The killer feature: LLM Skills Files. Every generated project includes comprehensive documentation in the .ai/ directory that helps AI assistants (Claude, ChatGPT, etc.) understand your codebase:

• Project architecture explained
• Navigation guides for finding code
• Common tasks with step-by-step instructions
• Security guidelines
• Best practices documentation

This means you can pair program with AI more effectively from day one.

⚡ Fast & Lightweight

Built in Go for speed:

• Generates full-stack projects in <2 seconds
• Single binary, no dependencies
• Works offline
• Cross-platform (macOS, Linux, Windows)

🔧 Flexible, Not Opinionated

Choose your stack:

• Frontend: React with Vite
• Backend: Node/Express or Python/FastAPI
• Database: PostgreSQL, MongoDB, SQLite, or none
• Auth: JWT, OAuth, or none
• Docker: Optional containerization

Mix and match as needed. The tool adapts to your preferences.

Generated Project Structure

Each generated project includes:

• Clean folder structure with separation of concerns
• Environment configuration (.env templates)
• Docker setup (optional)
• Security best practices
• LLM navigation files for AI-assisted development
• Comprehensive README

Development

# Install dependencies
make deps

# Run in development
make dev

# Build for all platforms
make build-all

# Build for current platform
make build

# Run tests
make test

# See all available commands
make help

License

MIT