π¦
Create Clean App
No description available
0 installs
Trust: 30 β Low
Other
Ask AI about Create Clean App
Powered by Claude Β· Grounded in docs
I know everything about Create Clean App. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
_ _
___ _ __ ___ __ _| |_ ___ ___| | ___ __ _ _ __
/ __| '__/ _ \/ _` | __/ _ \_____ / __| |/ _ \/ _` | '_ \
| (__| | | __/ (_| | || __/_____| (__| | __/ (_| | | | |
\___|_| \___|\__,_|\__\___| \___|_|\___|\__,_|_| |_|
I copy-pasted the same boilerplate for every project. Never again.
Scaffold MCP servers and microservices with Clean Architecture
Quick Start Β· Templates Β· What You Get Β· Architecture
Why I Built This
Every new project started the same way:
- Create folder structure (domain, application, infrastructure)
- Copy configs from last project (tsconfig, Dockerfile, docker-compose)
- Set up CI/CD workflow
- Initialize Git Flow branches
- Fix the things I forgot to copy
I automated all of it. Now I scaffold production-ready projects in seconds.
Demo
β create-clean-app
β
β What do you want to create?
β β MCP Server
β β Microservice / API
β
β Select your stack:
β β Go
β β NestJS
β
β Project name:
β my-mcp-server
β
β Description:
β GitHub repository monitor
β
β Select features:
β β Git Flow (main + develop branches)
β β Docker (Dockerfile + docker-compose)
β β GitHub Actions (CI/CD workflow)
β
β β Project created successfully!
Quick Start
# Run directly
npx @cjarero183006/create-clean-app
# Or with bun
bunx @cjarero183006/create-clean-app
# Or install globally
npm install -g @cjarero183006/create-clean-app
create-clean-app
Answer 5 questions. Get a complete project.
Templates
MCP Servers
| Stack | What you get |
|---|---|
| Go | mcp-go SDK, stdio transport, Clean Architecture layers, Makefile |
| NestJS | @modelcontextprotocol/sdk, decorators, dependency injection, TypeScript |
Microservices / APIs
| Stack | What you get |
|---|---|
| Go | Chi router, REST endpoints, Clean Architecture, health checks |
| NestJS | Full NestJS setup, controllers, services, DTOs, validation |
What You Get
Every template generates a production-ready structure:
my-project/
βββ domain/ # Entities & business rules
βββ application/ # Use cases & ports
βββ infrastructure/ # HTTP, MCP, DB adapters
βββ Dockerfile # Multi-stage build
βββ docker-compose.yml # Local development
βββ Makefile # build, run, test, lint
βββ .github/workflows/ # CI pipeline
βββ README.md # Project docs
Optional Features
| Feature | What it adds |
|---|---|
| Git Flow | Initializes repo with main and develop branches |
| Docker | Multi-stage Dockerfile, docker-compose.yml with volumes |
| GitHub Actions | CI workflow with lint, test, build steps |
Architecture
All templates follow Clean Architecture. Dependencies point inward.
βββββββββββββββββββββββββββββββββββββββββββ
β Domain β
β (Entities, Business Rules) β
β No external dependencies β
βββββββββββββββββββββββββββββββββββββββββββ€
β Application β
β (Use Cases, Ports) β
β Orchestrates domain logic β
βββββββββββββββββββββββββββββββββββββββββββ€
β Infrastructure β
β (HTTP, MCP, DB, External) β
β Implements ports (adapters) β
βββββββββββββββββββββββββββββββββββββββββββ
| Aspect | Choice |
|---|---|
| Architecture | Clean Architecture / Hexagonal |
| Testing | Vitest (40 passing) |
| Build | tsup (ESM) |
| CLI UI | @clack/prompts via cli-builder |
Development
git clone https://github.com/jarero321/create-clean-app.git
cd create-clean-app
bun install
bun run dev
| Script | What it does |
|---|---|
bun run dev | Run CLI in development mode |
bun test | Watch mode |
bun run test:run | Single run |
bun run test:coverage | Coverage report |
bun run build | Production build |
License
MIT
