@aegisx/create-app

Create enterprise-grade Nx monorepo with Angular and Fastify in seconds.

🚀 Quick Start

npx @aegisx/create-app my-project
cd my-project
nx serve api    # API on http://localhost:3333
nx serve web    # Web on http://localhost:4200
nx serve admin  # Admin on http://localhost:4201

📦 What's Included

• Nx Monorepo - Modern build system with caching
• 3 Apps Ready to Run:
  • api - Fastify backend with health checks
  • web - Angular SPA for public users
  • admin - Angular admin dashboard
• Shared Libraries:
  • shared/types - TypeScript interfaces
  • shared/utils - Common utilities
• Developer Experience:
  • Git hooks with Husky
  • Commit linting
  • Code formatting with Prettier
  • Linting with ESLint
  • Testing with Jest
• Docker Ready - PostgreSQL & Redis
• Full Documentation - Architecture guides

🎯 Interactive Mode

npx @aegisx/create-app

You'll be prompted for:

• Project name
• Target directory
• Docker setup
• Database migrations

⚡ Skip All Prompts

npx @aegisx/create-app my-project -y

📋 CLI Options

Options:
  -V, --version     output the version number
  -y, --yes         skip prompts and use defaults
  --skip-git        skip git initialization
  --skip-install    skip dependency installation
  -h, --help        display help for command

🛠️ Requirements

• Node.js >= 18
• Yarn (will be installed automatically if not present)

📁 Project Structure

my-project/
├── apps/
│   ├── api/         # Fastify backend
│   ├── web/         # Angular public app
│   └── admin/       # Angular admin app
├── libs/
│   └── shared/
│       ├── types/   # Shared TypeScript types
│       └── utils/   # Shared utilities
├── docs/            # Complete documentation
├── nx.json          # Nx configuration
└── package.json     # Dependencies

🚀 Next Steps

After creating your project:

1. Start Development

   nx serve api    # Backend on :3333
   nx serve web    # Frontend on :4200
   nx serve admin  # Admin on :4201

2. Run Tests

   nx test api
   nx test web
   nx test admin

3. Build for Production

   nx build api --prod
   nx build web --prod
   nx build admin --prod

📚 Documentation

Full documentation is included in the docs/ directory:

• Architecture guides
• Development workflows
• Testing strategies
• Deployment guides

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines.

📄 License

MIT