angular-new-app

Files (1)

• SKILL.md

SKILL.md (first lines)

# Angular New App

You are an expert in TypeScript, Angular, and scalable web application development. You write functional, maintainable, performant, and accessible code following Angular and TypeScript best practices. You have access to tools to create new Angular apps.

## Project Style Guide (applies after scaffolding)

Once the app is generated, all subsequent code must follow the project style guide. Read it before generating Angular source files:

- [../../style-guide/style-guide.md](../../style-guide/style-guide.md) — index
- [../../style-guide/style-guide.ts.md](../../style-guide/style-guide.ts.md)
- [../../style-guide/style-guide.html.md](../../style-guide/style-guide.html.md)
- [../../style-guide/style-guide.scss.md](../../style-guide/style-guide.scss.md)

For the high-leverage overrides (signal-based I/O, OnPush everywhere, `inject()` over constructor DI, native control flow, `class.x` / `style.x` over `ngClass` / `ngStyle`, `AsyncPipe` + `takeUntilDestroyed`, `private`/`readonly`/`const` defaults, no `standalone: true`, etc.), see the same overrides block in [../angular-developer/SKILL.md](../angular-developer/SKILL.md).

Prefer Reactive Forms for production forms unless the user explicitly chooses experimental Signal Forms for a new Angular v21+ form or prototype.

**Scaffolding defaults for this project:**

- `--style=scss`
- `--routing`
- `--prefix=app` (or match an existing prefix in the workspace)
- `--ai-config=agents` (project uses `AGENTS.md` as the source of truth)
- Set up Husky + lint-staged + Prettier + Angular ESLint immediately after scaffolding (see [../../README.md](../../README.md)).

When creating a new Angular application for a user, always follow the following steps:

1. **Check for the Angular CLI**: Confirm that the Angular CLI is present before continuing. Here are some ways to confirm:
   - on `*nix` systems `which ng`
   - on Windows systems `where ng`, if powershell `gcm ng`

   If it is present, skip to step 2, if not, ask the user if they'd like to install it globally for the user with the following command:

   `npm install -g @angular/cli`

   _IMPORTANT_: There are best practices available for building outstanding Angular applications via the MCP server that is bundled with the Angular CLI. Available through `ng mcp` and the `get_best_practices`.

2. **Create the new application**: To create the application either suggest a name based on the user prompt or ask the user the name of the application. Create the application with the following command:

   `npx ng new <app-name> [list of flags based on the description of the app] --interactive=false --ai-config=[agents, claude, copilot, cursor, gemini, jetbrains, none, windsurf]`

   _Important_: Prefer agent for `--ai-config`, or use the option that best suits the environment, for example if the user is using Gemini, use `--ai-config=gemini`.

   Load the contents of that AI configuration into memory so that you can refer to it when generating code for the user. This will help you generate code that is consistent with modern Angular best practices.

   Consider these commonly useful flags based on the user's requirements:
   - `--style=scss|css|less` — stylesheet format
   - `--routing` — add routing module
   - `--ssr` — enable server-side rendering
   - `--prefix=<prefix>` — component selector prefix
   - `--skip-tests` — only if the user explicitly requests it

3. Do not start the app until you've built some features, ask the user if they want to start the app. You can always run `npx ng build` to check for errors and repair them.

4. Remember the following guidelines for continuing to generate Angular application code:
   - To generate components, use the Angular CLI `npx ng generate component <component-name>`
   - To generate services, use the Angular CLI `npx ng generate service <service-name>`
   - To generate pipes, use the Angular CLI `npx ng generate pipe <pipe-name>`
   - To generate directives, use the Angular CLI `npx ng generate directive <directive-name>`
   - To generate interfaces, use the Angular CLI `npx ng generate interface <interface-name>` only when an interface is genuinely needed; otherwise prefer `type` aliases per the workspace TypeScript style guide.
   - To generate guards, use the Angular CLI `npx ng generate guard <guard-name>`
   - To generate interceptors, use the Angular CLI `npx ng generate interceptor <interceptor-name>`
   - To generate resolvers, use the Angular CLI `npx ng generate resolver <resolver-name>`
   - To generate enums, use the Angular CLI `npx ng generate enum <enum-name>`
   - To generate classes, use the Angular CLI `npx ng generate class <class-name>`

   _IMPORTANT_: Take note of the path returned from running the generate commands so that you know exactly where the new files are.

   Use the Angular CLI to generate the code, then augment the code to meet the needs of the application.

5. To add tailwind, run `npx ng add tailwindcss`. After that, you do not have to do anything else, you can start using tailwind classes in your Angular application. Follow the best practices for tailwind v4 here, learn more if needed: https://tailwindcss.com/docs/upgrade-guide.

_IMPORTANT_: There are best practices available for building outstanding Angular applications via the MCP server that is bundled with the Angular CLI. Available through `npx ng mcp` and the `get_best_practices`.

From L-X-T/ng-days-refactoring-ai, MIT.

More from L-X-T/ng-days-refactoring-ai