Quick Start

Create a new project instantly with the interactive wizard:

npx flatron MyApp

Or install globally:

npm install -g flatron
flatron MyApp

Features

• Clean Architecture by Default: Modular domain, application, infrastructure, and presentation layers.
• Full Stack Flexibility: Scaffold full-stack apps, standalone APIs, or modern frontend clients.
• Modern Ecosystem: ASP.NET Core, React (Next.js / Vite), Angular, Tailwind CSS, EF Core, and more.
• Fast & Interactive: Guided interactive prompts with support for one-line non-interactive flags (--yes).

What Can Flatron Create?

| Mode | Description | Key Technologies | | :--- | :--- | :--- | | Full Stack | Unified solution with separated Backend/ and Frontend/ workspaces | .NET 10 + React / Angular | | Backend Only | ASP.NET Core Clean Architecture API with CQRS or Service patterns | EF Core, Dapper, SQL Server, PostgreSQL, SQLite, JWT Auth | | Frontend Only | Modern SPA or SSR web application ready for production | Next.js, Vite (React), Angular, Tailwind CSS, shadcn/ui |

CLI Usage

Project Scaffolding

# Interactive mode
npx flatron MyApp

# Non-interactive with recommended defaults
npx flatron MyApp --yes

# Backend-only API with PostgreSQL and JWT auth
npx flatron my-api --type backend --db postgresql --auth jwt --yes

# Frontend-only app with React, Vite, and Tailwind
npx flatron my-ui --type frontend --frontend react --frontend-tooling vite --styling tailwind --yes

Feature & Module Generation

Inside a Flatron project:

# Generate a business entity feature (interactive wizard)
flatron create feature Product

# Install an application module
flatron create module
flatron create module auth

(Legacy create-fullstack-feature and create-fullstack-module remain supported for backward compatibility.)

To see all available flags and options:

npx flatron --help

Requirements

• Node.js ≥ 20
• .NET SDK ≥ 10.0 (for .NET backend projects)

License

MIT © Ahmed Ibrahim