Angular Project Automator 🚀

A comprehensive command-line interface (CLI) tool designed to automate and streamline the initialization of Angular projects with intelligent version management, interactive library search, and comprehensive prerequisite handling.

✨ Features

Core Features

• 🔍 System Environment Check - Displays Node.js, npm, nvm, and Angular CLI versions before starting
• 📦 Angular Version Selection - Fetches and displays all available Angular versions from npm registry
• ✅ Prerequisite Compatibility Check - Validates Node.js compatibility with selected Angular version
• 🔄 Smart Node Version Management - Automatically handles Node version switching with nvm
• 💾 Node.js Installation Assistant - Guides installation when nvm is not available
• 📍 Project Location Configuration - Choose current or custom directory for project creation
• 🎯 Project Initialization - Creates Angular project with selected configuration

Advanced Features

• 🎨 Pre-configured Project Templates

  • Basic SPA (Minimal setup)
  • Enterprise (NgRx, Material, ESLint)
  • PWA Ready (Service workers, offline support)
  • Material Design (Angular Material components)
  • Testing Ready (Jest, Testing Library)
  • Standalone Components (Modern Angular)

• 🔍 Interactive Library Search & Installation

  • Real-time npm package search with autocomplete
  • Package validation and metadata display
  • Weekly download statistics
  • Version selection (latest or specific)
  • Multiple library queue management

• 📦 Popular Library Bundles

  • UI Framework Bundle (Material + CDK + Flex Layout)
  • State Management Bundle (NgRx suite)
  • Form & Validation Bundle
  • Testing Bundle (Jest + Testing Library)
  • Performance Bundle (Universal + optimization)
  • Authentication Bundle (Firebase integration)
  • Utilities Bundle (Lodash, date-fns, RxJS)
  • HTTP & API Bundle

• 🔧 Configuration Presets

  • TypeScript strict mode
  • ESLint + Prettier setup
  • Husky pre-commit hooks
  • Custom configurations

• 📁 Project Structure Generator

  • Standard Angular structure (core, shared, features)
  • Domain-driven structure
  • Automatic folder and file generation

• 🔐 Environment Configuration

  • Environment file templates
  • Configuration management

• 🚀 Git Integration

  • Initialize repository
  • Create .gitignore with Angular-specific entries
  • Initial commit creation

• 📚 Documentation Generation

  • Auto-generate README.md
  • CHANGELOG.md template
  • Project structure documentation

• 💾 Profile Management

  • Save configurations as reusable profiles
  • Load saved profiles for quick setup
  • Export/import profiles for sharing
  • Cloud-ready profile system

📋 Prerequisites

• Node.js: v18.0.0 or higher
• npm: Comes with Node.js
• nvm (optional but recommended): For managing multiple Node.js versions

🚀 Installation

Global Installation (Recommended)

npm install -g ng-angular-setup

Or use with npx (no installation)

npx ng-angular-setup

📖 Usage

Create New Project (Interactive)

ng-angular-setup

or

ng-angular-setup create

This starts the interactive CLI that guides you through:

1. System environment check
2. Angular version selection
3. Node.js compatibility check and resolution
4. Project configuration
5. Template selection
6. Library search and installation
7. Additional features setup
8. Profile saving option

Check System Versions

ng-angular-setup check

Displays current versions of Node.js, npm, nvm, and Angular CLI.

Profile Management

List all saved profiles

ng-angular-setup profile list

Show profile details

ng-angular-setup profile show <profile-name>

Delete a profile

ng-angular-setup profile delete <profile-name>

Export a profile

ng-angular-setup profile export <profile-name> <output-file>

Example:

ng-angular-setup profile export my-enterprise-setup ./enterprise-profile.json

Import a profile

ng-angular-setup profile import <profile-file>

Example:

ng-angular-setup profile import ./enterprise-profile.json

Show Usage Examples

ng-angular-setup examples

🎯 Usage Examples

Example 1: Create Enterprise Project with Material

1. Run ng-angular-setup
2. Select Angular version 17
3. Choose "Enterprise" template
4. Select "Interactive search" for libraries
5. Search and add additional packages
6. Enable Git initialization
7. Enable README generation
8. Save as profile for future use

Example 2: Quick Setup with Saved Profile

1. Run ng-angular-setup
2. Select "Yes" to use saved profile
3. Choose your saved profile
4. Confirm configuration
5. Project is created automatically

Example 3: PWA Project with Testing

1. Run ng-angular-setup
2. Select latest Angular version
3. Choose "PWA Ready" template
4. Select "Testing Bundle" from bundles
5. Enable ESLint + Prettier
6. Enable Husky hooks
7. Project created with complete testing setup

🏗️ Project Structure

ng-angular-setup/
├── src/
│   ├── commands/              # CLI command handlers
│   ├── utils/                 # Helper functions
│   │   ├── version-checker.js    # Version detection and management
│   │   ├── compatibility.js      # Compatibility checking
│   │   ├── npm-search.js         # npm registry search
│   │   ├── installer.js          # Package installation
│   │   ├── prompt-handler.js     # Interactive prompts
│   │   ├── file-utils.js         # File operations
│   │   └── profile-manager.js    # Profile management
│   ├── templates/             # Project templates
│   │   └── templates.js          # Template definitions
│   ├── index.js              # CLI entry point
│   └── runner.js             # Main CLI flow
├── package.json
└── README.md

🔧 Configuration

Project Templates

The CLI includes several pre-configured templates:

• basic: Minimal Angular setup with routing
• enterprise: Complete setup with NgRx, Material, ESLint
• pwa: Progressive Web App ready
• material: Angular Material UI components
• testing: Jest and Testing Library setup
• standalone: Modern standalone components

Library Bundles

Pre-configured library combinations for common use cases:

• uiFramework: Angular Material suite
• stateManagement: NgRx complete setup
• forms: Form utilities and validators
• testing: Complete testing stack
• performance: Optimization tools
• authentication: Auth integration
• utilities: Common utility libraries
• http: HTTP and API tools

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🐛 Bug Reports & Feature Requests

If you encounter any bugs or have feature requests, please create an issue on GitHub.

📚 Documentation

For detailed documentation, visit PROJECT_DOCUMENTATION.md

🙏 Acknowledgments

• Angular Team for the amazing framework
• Node.js and npm communities
• All open-source contributors

📞 Support

• GitHub Issues: Report issues
• Email: [email protected]

🎉 Success Metrics

• ⏱️ 80% reduction in project initialization time
• ✅ Zero environment setup errors with guided installation
• 🚀 Instant project scaffolding with best practices
• 💾 Reusable profiles for team standardization

Made with ❤️ by the Angular community

Last Updated: January 30, 2026