# Nean Add Feature

> Scaffold a new feature with NestJS module, TypeORM entity, DTOs, and Angular components.

- Skill: `majiayu000/nean-add-feature` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/nean-add-feature`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/nean-add-feature/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-add-feature

---


## Purpose
Add a complete feature slice to an existing NEAN project with all layers wired up and tests included.

## Arguments
- `feature-name` — Feature name in kebab-case (e.g., `user-profile`, `invoice`)
- `--no-ui` — Skip Angular components (API-only feature)
- `--no-api` — Skip NestJS module (frontend-only feature)
- `--no-entity` — Skip TypeORM entity (use existing entity)

## What gets created

### Default (all layers)
```
libs/shared/types/src/<feature>.dto.ts           # DTOs + interfaces
libs/api/database/src/entities/<feature>.entity.ts   # TypeORM entity
apps/api/src/modules/<feature>/
  <feature>.module.ts
  <feature>.controller.ts
  <feature>.service.ts
  __tests__/
    <feature>.controller.spec.ts
    <feature>.service.spec.ts
apps/web/src/app/<feature>/
  <feature>.routes.ts
  <feature>-list/
    <feature>-list.component.ts
  <feature>-form/
    <feature>-form.component.ts
  <feature>-detail/
    <feature>-detail.component.ts
libs/web/data-access/src/<feature>/
  <feature>.service.ts
  <feature>.store.ts  (NgRx feature state)
```

### With flags
- `--no-ui`: Only DTOs + entity + NestJS module
- `--no-api`: Only DTOs + Angular components + data-access
- `--no-entity`: Only DTOs + NestJS module + Angular (uses existing entity)

## Conventions

### Naming
- Feature name: `kebab-case` (input)
- Classes: `PascalCase` (e.g., `UserProfile`, `CreateUserProfileDto`)
- Files: `kebab-case.ts` for everything
- API routes: `/api/<feature>` for collection, `/api/<feature>/:id` for item

### DTO location
All DTOs go in `libs/shared/types/src/<feature>.dto.ts`:
- `Create<Feature>Dto` — creation input with validation decorators
- `Update<Feature>Dto` — partial update input (PartialType)
- `<Feature>ResponseDto` — API response shape
- Interfaces exported alongside classes

### API endpoint structure
- `GET /api/<feature>` — list (paginated)
- `POST /api/<feature>` — create
- `GET /api/<feature>/:id` — get one
- `PATCH /api/<feature>/:id` — update
- `DELETE /api/<feature>/:id` — delete

### Entity conventions
- Timestamps enabled (@CreateDateColumn, @UpdateDateColumn)
- Indexes defined with comments explaining why
- UUID primary keys by default
- Soft delete pattern if deletion is reversible

## Workflow
1. Create DTOs in libs/shared/types
2. Create TypeORM entity (if not --no-entity)
3. Create NestJS module with controller + service (if not --no-api)
4. Create Angular components and routing (if not --no-ui)
5. Create NgRx feature state
6. Create tests for each layer
7. Run `npm run lint` and `npm run test` to verify

## Output
Summarize: files created, API endpoints available, components ready to use.

## Reference
For templates and patterns, see `reference/nean-add-feature-reference.md`