# Nean Stack

> Stack decisions for NEAN apps (NestJS, Angular, Nx monorepo). Reference before scaffolding or architecture work.

- Skill: `majiayu000/nean-stack` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/nean-stack`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/nean-stack/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/nean-stack

---


## Locked decisions

| Layer          | Decision                                                  |
| -------------- | --------------------------------------------------------- |
| Monorepo       | Nx with integrated monorepo                               |
| Frontend       | Angular 21+ (standalone, zoneless), TypeScript required   |
| UI Components  | PrimeNG 21+ + Tailwind CSS v4                             |
| State          | NgRx (signals-based where appropriate)                    |
| Backend        | NestJS 11+ with TypeScript                                |
| ORM            | TypeORM with PostgreSQL                                   |
| Validation     | class-validator + class-transformer                       |
| Shared Types   | `libs/shared/types` (DTOs, interfaces, enums)             |
| Auth           | Passport.js (JWT + Refresh tokens)                        |
| Authorization  | CASL (attribute-based access control)                     |
| API Docs       | Swagger/OpenAPI via @nestjs/swagger                       |
| Environments   | local → staging → production                              |
| Secrets        | `.env` files for dev; cloud provider secrets for prod     |
| Containers     | Docker for production; optional for development           |

## Project layout

```
<app-name>/
├── apps/
│   ├── api/                    # NestJS backend
│   │   └── src/
│   │       ├── app/            # Root module
│   │       ├── modules/        # Feature modules
│   │       └── main.ts         # Entry point
│   └── web/                    # Angular frontend
│       └── src/
│           ├── app/            # Root component + routing
│           └── main.ts         # Bootstrap
├── libs/
│   ├── shared/
│   │   └── types/              # DTOs, interfaces, enums (used by both)
│   ├── api/
│   │   ├── database/           # TypeORM config, entities
│   │   └── common/             # Interceptors, filters, pipes
│   └── web/                    # (added as needed for feature libs)
├── docker/
│   ├── Dockerfile.api
│   ├── Dockerfile.web
│   ├── docker-compose.yml
│   └── nginx.conf
├── nx.json
├── package.json
└── tsconfig.base.json
```

## When to add additional services

Only justified if:

- Long-running jobs exceed typical request timeouts
- WebSocket/persistent connections required at scale
- Separate scaling requirements for specific workloads
- Compliance requires service isolation
- Background job processing (consider Bull/BullMQ first)

Default: keep API in single NestJS application with modules.

## Reference

For versions, env setup, and deployment patterns, see `reference/nean-stack-reference.md`