Angular Clean Architecture CLI

🚀 Scaffold Angular features following Clean Architecture principles with NgRx SignalStore.

A powerful CLI that generates production-ready Angular features structured into Domain, Infrastructure, Application, and UI layers — keeping your codebase maintainable, testable, and scalable.

---

📦 Installation

# Global installation (recommended)
npm install -g @devmed555/angular-clean-architecture-cli

# Verify installation
aca --version

Prerequisites

• Node.js v20+
• Angular 21+ project
• @ngrx/signals installed: npm install @ngrx/signals

---

⚡ Quick Start

# 1. Generate all features defined in feature-schema.json
aca g feature

# 2. Generate a single feature with attributes
aca g feature product --attributes="name:string,price:number"

# 3. Generate ALL core assets (Auth, Navbar, Menu, etc.)
aca g core

# 4. Generate ALL shared components
aca g shared

---

🛠️ Generators

Command	Description
aca g feature	Generates Clean Architecture features (4 layers)
aca g core	Generates core system assets (Auth, Guards, Services)
aca g shared	Generates shared UI components & utilities

---

📁 Feature Generator

Creates a structure with Domain, Infrastructure, Application, and UI layers.

Usage

# Interactive mode
aca g feature

# With inline attributes
aca g feature product --attributes="name:string,price:number,active:boolean"

# From blueprint file
aca g feature --blueprint=./order.json

---

🔧 Core Generator

Running aca g core without arguments automatically generates ALL core assets:

• Auth: Service with login/logout logic
• Navbar: Top navigation component
• Menu: Side navigation component
• Theme Selector: Dark/Light mode toggle
• Language Selector: i18n switcher
• Translate: Translation setup

Generated Assets

Asset	Description
navbar	Top navigation bar
menu	Side navigation menu
theme-selector	Dark/light theme toggle
language-selector	Language switcher component
translate	i18n translation setup
auth	Authentication service with login/logout

---

🎨 Shared Generator

Running aca g shared without arguments automatically generates standard shared components:

• Confirm Dialog: Reusable confirmation modal

Generated Components

• Confirm Dialog: Reusable confirmation modal

---

📋 Blueprint Mode

For complex features with multiple models, use a JSON blueprint:

{
  "name": "shop",
  "models": [
    {
      "name": "Product",
      "attributes": [{ "name": "price", "type": "number" }]
    },
    {
      "name": "Cart",
      "attributes": [{ "name": "total", "type": "number" }]
    }
  ]
}

aca g feature --blueprint=./shop.json

---

🔮 Coming Soon

• Unit Test Templates: Comprehensive tests for all layers
• Custom Types (UML): Generate features from UML/PlantUML models
• MCP Server: AI integration for smarter code generation

---

🏛️ Architecture Overview

Generated features follow Clean Architecture (Hexagonal Architecture) principles:

┌─────────────────────────────────────────────────────────┐
│                         UI Layer                         │
│              (Components, Templates, Styles)             │
├─────────────────────────────────────────────────────────┤
│                    Application Layer                     │
│              (NgRx SignalStore, Selectors)               │
├─────────────────────────────────────────────────────────┤
│                  Infrastructure Layer                    │
│              (HTTP Services, API Clients)                │
├─────────────────────────────────────────────────────────┤
│                      Domain Layer                        │
│          (Interfaces, Types, Business Rules)             │
└─────────────────────────────────────────────────────────┘

• Domain: Pure TypeScript, zero dependencies
• Infrastructure: Depends on Domain
• Application: Depends on Infrastructure + Domain
• UI: Depends on Application

---

🔗 Nx Workspace Integration

When using within an Nx monorepo:

# Generate feature using Nx
nx g cli:feature product

# Generate core assets
nx g cli:core

# Generate shared components
nx g cli:shared

---

📚 Resources

• Architecture Documentation
• Examples & Scenarios
• Roadmap

---

📝 License

MIT © Mohamed Bouattour