4e8e5069fa
- Added: api-patterns, app-builder, architecture, bash-linux, behavioral-modes, clean-code, code-review-checklist, database-design, deployment-procedures, docker-expert, documentation-templates, game-development, geo-fundamentals, i18n-localization, lint-and-validate, mobile-design, nestjs-expert, nextjs-best-practices, nodejs-best-practices, parallel-agents, performance-profiling, plan-writing, powershell-windows, prisma-expert, python-patterns, react-patterns, red-team-tactics, seo-fundamentals, server-management, tailwind-patterns, tdd-workflow, typescript-expert, vulnerability-scanner - Updated README: skill count 179 → 223 - Added credit for vudovn/antigravity-kit (MIT License) Source: https://github.com/vudovn/antigravity-kit
84 lines
1.7 KiB
Markdown
84 lines
1.7 KiB
Markdown
---
|
|
name: express-api
|
|
description: Express.js REST API template principles. TypeScript, Prisma, JWT.
|
|
---
|
|
|
|
# Express.js API Template
|
|
|
|
## Tech Stack
|
|
|
|
| Component | Technology |
|
|
|-----------|------------|
|
|
| Runtime | Node.js 20+ |
|
|
| Framework | Express.js |
|
|
| Language | TypeScript |
|
|
| Database | PostgreSQL + Prisma |
|
|
| Validation | Zod |
|
|
| Auth | JWT + bcrypt |
|
|
|
|
---
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
project-name/
|
|
├── prisma/
|
|
│ └── schema.prisma
|
|
├── src/
|
|
│ ├── app.ts # Express setup
|
|
│ ├── config/ # Environment
|
|
│ ├── routes/ # Route handlers
|
|
│ ├── controllers/ # Business logic
|
|
│ ├── services/ # Data access
|
|
│ ├── middleware/
|
|
│ │ ├── auth.ts # JWT verify
|
|
│ │ ├── error.ts # Error handler
|
|
│ │ └── validate.ts # Zod validation
|
|
│ ├── schemas/ # Zod schemas
|
|
│ └── utils/
|
|
└── package.json
|
|
```
|
|
|
|
---
|
|
|
|
## Middleware Stack
|
|
|
|
| Order | Middleware |
|
|
|-------|------------|
|
|
| 1 | helmet (security) |
|
|
| 2 | cors |
|
|
| 3 | morgan (logging) |
|
|
| 4 | body parsing |
|
|
| 5 | routes |
|
|
| 6 | error handler |
|
|
|
|
---
|
|
|
|
## API Response Format
|
|
|
|
| Type | Structure |
|
|
|------|-----------|
|
|
| Success | `{ success: true, data: {...} }` |
|
|
| Error | `{ error: "message", details: [...] }` |
|
|
|
|
---
|
|
|
|
## Setup Steps
|
|
|
|
1. Create project directory
|
|
2. `npm init -y`
|
|
3. Install deps: `npm install express prisma zod bcrypt jsonwebtoken`
|
|
4. Configure Prisma
|
|
5. `npm run db:push`
|
|
6. `npm run dev`
|
|
|
|
---
|
|
|
|
## Best Practices
|
|
|
|
- Layer architecture (routes → controllers → services)
|
|
- Validate all inputs with Zod
|
|
- Centralized error handling
|
|
- Environment-based config
|
|
- Use Prisma for type-safe DB access
|