create-claude-app 0.1.0

Interactive Python CLI tool that scaffolds new projects optimized for Claude Code development

create-claude-app

Interactive Python CLI tool that scaffolds new projects optimized for Claude Code development. Creates structured project templates with comprehensive CLAUDE.md files to enable developers to quickly start new projects with Claude Code.

Features

• 🚀 Quick Project Setup: Bootstrap new projects in under 2 minutes
• 🎯 Interactive Selection: Choose from multiple frontend, backend, and database options
• 📋 Comprehensive Documentation: Auto-generated CLAUDE.md files for effective AI-assisted development
• 🏗️ Clean Architecture: Industry best practices with Domain-Driven Design patterns
• 🔧 Multiple Tech Stacks: Support for React, Vue, Angular, Python, Node.js, Golang, and more
• 📦 Database Integration: MySQL, PostgreSQL, SQLite with Atlas migration tool support
• 🎨 UI Framework Support: Tailwind CSS, shadcn/ui with automatic compatibility checking
• ⚡ Build Tool Selection: Vite, Webpack, Babel + Webpack with optimized configurations
• 🔄 GitHub Actions CI/CD: Automated workflow generation for testing and deployment
• 📁 Framework Entry Points: Production-ready entry files for all supported frameworks
• 📚 Enhanced README: Detailed setup, development, and deployment instructions
• 🐳 Docker Infrastructure: Complete containerization with multi-stage builds and environment-specific configurations
• 🏗️ Docker Compose: Development, staging, and production docker-compose files with optimized configurations

Installation

# Install via pip
pip install create-claude-app

# Install via homebrew (coming soon)
brew tap yourusername/create-claude-app
brew install create-claude-app

Usage

# Create a new project
create-claude-app my-new-project

# Follow the interactive prompts to select your tech stack

Interactive Component Selection

The tool will guide you through selecting components for your project:

Frontend Framework Options

• React (TypeScript, modern hooks)
• Vue (Vue 3 with Composition API)
• Angular (Latest Angular with TypeScript)
• Skip

UI Framework Options

• Tailwind CSS (complete setup with configuration)
• shadcn/ui (component library with TypeScript)
• None/Skip

Backend Options

• Python (FastAPI with DDD/Service Layer)
• Node.js (Express.js with TypeScript)
• Golang (Gin framework with clean architecture)
• Skip

Database Options

• MySQL
• PostgreSQL
• SQLite
• Skip

Build Tool Options (for frontend)

• Vite (recommended - fast HMR, optimized builds)
• Webpack (traditional bundling with extensive configuration)
• Babel + Webpack (custom transpilation with webpack bundling)

Additional Options

• Atlas migration tool (recommended)
• Package manager selection (npm, yarn)
• GitHub Actions CI/CD workflows (recommended)
• Docker infrastructure generation (recommended)
• Comprehensive project documentation generation

Generated Project Structure

Full Stack Example

my-project/
├── README.md              # Comprehensive project documentation
├── CLAUDE.md              # Main project documentation
├── .env.example           # Environment variables template
├── .gitignore
├── package.json           # Root-level npm scripts, workspaces
├── requirements.txt       # Project Python dependencies
├── docker-compose.yml     # Main docker-compose configuration
├── docker-compose.dev.yml # Development environment configuration
├── docker-compose.staging.yml # Staging environment configuration
├── docker-compose.prod.yml # Production environment configuration
├── .github/               # GitHub Actions workflows
│   ├── workflows/
│   │   └── ci.yml         # Continuous integration
│   └── CLAUDE.md          # CI/CD documentation
├── infra/                 # Docker infrastructure
│   └── docker/
│       ├── frontend/
│       │   └── Dockerfile # Frontend container (multi-stage build)
│       ├── backend/
│       │   └── Dockerfile # Backend container (Python/Node.js/Golang)
│       └── database/
│           └── Dockerfile # Database container (MySQL/PostgreSQL)
├── frontend/              # React/Vue/Angular application
│   ├── CLAUDE.md          # Frontend-specific documentation
│   ├── package.json
│   ├── vite.config.ts     # Build tool configuration
│   ├── src/
│   │   ├── main.tsx       # Application entry point
│   │   └── App.tsx        # Main component
│   ├── public/
│   └── ...
├── backend/               # Python/Node.js/Golang API
│   ├── CLAUDE.md          # Backend-specific documentation
│   ├── app/
│   │   ├── main.py        # FastAPI application entry point
│   │   ├── api/           # API routes
│   │   ├── domain/        # Domain models
│   │   ├── services/      # Business logic
│   │   └── repositories/  # Data access layer
│   ├── requirements.txt
│   ├── Dockerfile         # Container configuration
│   └── ...
└── migrations/            # Database migrations (Atlas)
    ├── CLAUDE.md          # Migration documentation
    └── atlas.hcl          # Atlas configuration

CLAUDE.md Documentation

Each generated project includes comprehensive CLAUDE.md files containing:

• Project Description Template
• Technology Stack Overview (including build tools and CI/CD)
• Environment Setup Instructions
• Development Commands (framework-specific with build tools)
• Architecture Patterns
• Coding Standards
• Testing Guidelines
• Build and Deployment Instructions
• CI/CD Pipeline Documentation (if GitHub Actions selected)
• Docker Commands and Infrastructure (complete containerization guide)
• AI API Keys Setup (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY)

Environment Variables

Generated projects include .env.example templates with:

# AI API Keys
ANTHROPIC_API_KEY=your_anthropic_api_key_here
OPENAI_API_KEY=your_openai_api_key_here
GEMINI_API_KEY=your_gemini_api_key_here

# Database Configuration
DATABASE_URL=your_database_url_here
DB_HOST=localhost
DB_PORT=5432

# Application Settings
ENV=development
DEBUG=true
PORT=8000

Requirements

• Python 3.8+
• Cross-platform compatibility (Windows, macOS, Linux)

Development

# Clone the repository
git clone https://github.com/swhsiang/create-claude-app.git
cd create-claude-app

# Install in development mode
pip install -e .
pip install -r requirements-dev.txt

# Run tests
pytest tests/ -v
pytest tests/ --cov=src/create_claude_app

# Run with coverage report
pytest tests/ --cov=src/create_claude_app --cov-report=html

Contributing

1. Fork the repository
2. Create a feature branch
3. Follow Google Python Style Guide
4. Add tests for new functionality
5. Submit a pull request

Issues and Support

Report issues at: https://github.com/swhsiang/create-claude-app/issues

License

MIT License - see LICENSE file for details

Roadmap

✅ Recently Completed (v0.3.0)

• Docker Infrastructure: Complete containerization with multi-stage builds
• Environment-Specific Configurations: dev, staging, prod docker-compose files
• Docker Optimization: Security best practices, health checks, resource limits
• Enhanced README with Docker: Complete Docker commands and infrastructure guide

✅ Previous Features (v0.2.0)

• Frontend Build Tools: Vite, Webpack, Babel + Webpack support
• GitHub Actions CI/CD: Comprehensive workflow generation
• Framework Entry Points: React, Vue, Angular, Python entry files
• Enhanced README Generation: Detailed development instructions
• Build Tool Configurations: Vite and Webpack config files
• Package Manager Selection: npm, yarn support

🔄 In Progress

• Testing Framework Integration: Jest, Vitest, Pytest templates
• Database ORM Integration: Prisma, SQLAlchemy, TypeORM

📋 Planned Features

• IDE Configuration Files: VS Code, JetBrains settings
• Deployment Templates: Vercel, Netlify, AWS, GCP configurations
• Kubernetes Support: Helm charts and k8s manifests