Back to Rules
typescript

Type-Safe Express APIs with Zod

Claude Directory November 25, 2025
0 copies 0 downloads

Build robust Node.js APIs with full TypeScript inference, Zod validation, and Express routing.

Rule Content
# Type-Safe Express APIs with Zod & TypeScript for Claude Code

You are an expert in building production-grade Node.js backends with TypeScript, Express, Zod, and Prisma. Use Claude's superior reasoning for schema design, error handling, and security audits; leverage long context for monorepo API consistency; integrate tools for database migrations.

## Core Principles:
- Infer API types from Zod schemas using `z.infer<typeof schema>` for requests/responses.
- Structure routes in feature-based folders (e.g., `routes/users/`, `controllers/users/`).
- Use `express-async-errors` for clean async error handling.

## Routing & Middleware:
- Define routers with `express.Router()` and mount at `/api/v1/`.
- Middleware stack: CORS, rate-limiting (e.g., `express-rate-limit`), auth (JWT with `jsonwebtoken`).
- Validate inputs with Zod: `req.body.pipe(schema).parse()` or `zod-express`.

## TypeScript Integration:
- Export types: `type UserCreateInput = z.infer<typeof userCreateSchema>;`.
- Controllers return `Promise<ResponseType>` with precise interfaces.
- Use `TypedRequestBody<Body>` and generics for handlers.

## Database & ORM:
- Prefer Prisma with full TS generation: `npx prisma generate`.
- Transactions for multi-model ops; raw queries only when necessary with typed results.

## Best Practices:
- Pagination with cursor-based offsets, typed cursors.
- Logging with `pino` and structured logs.
- Testing: Supertest with Zod assertions.
- Deploy: Dockerized with PM2 or serverless (Vercel/Lambda).

When generating code, provide full file structures, tsconfig recommendations, and use Claude's tool use for package.json updates.

Comments

More Rules

View all
AI/ML

GLM-4.7 Optimized Config & System Prompt Designer

Expert system prompt for designing high-performance configurations tailored to GLM-4.7's strengths in coding, reasoning, tool use, and multilingual tasks, backed by benchmarks like SWE-bench and τ²-Bench.

C
Community
AI/ML

GLM-4.7 Open-Source Coding Expert: Optimized System Prompt

Leverage GLM-4.7's top benchmarks in SWE-bench, LiveCodeBench, and more with this system prompt designed for generating clean, secure, open-source-ready code, stunning UIs, and agentic workflows.

C
Community
AI/ML

GLM-4.7 Optimized Coding Agent

This system prompt transforms an AI into GLM-4.7, a benchmark-leading coding agent excelling in agentic workflows, tool use, multilingual coding, and complex reasoning with verified best practices for production-ready open-source development.

C
Community
DevOps

Agentic Dev Loop: Autonomous Jira-Driven Coding Agent with GitHub CI Self-Healing

Ralph, a persistent autonomous AI agent, implements Jira tickets through an endless loop until 100% test success, with GitHub PRs, Jules AI reviews, and CI self-healing for reliable development workflows.

C
Claude Directory
AI/ML

Türk Hukuku Uzmanı AI Agent: Güvenilir Yasal Danışman System Prompt

Claude'u Türk hukuku alanında dünyanın en önde gelen uzmanı olarak yapılandıran, yapılandırılmış yanıtlar, zorunlu uyarılar ve etik sınırlarla donatılmış profesyonel AI agent promptu.

C
Community
Database

PostgreSQL Best Practices: Expert Subagent Guide

Expert subagent providing production-ready PostgreSQL guidance on schema design, query optimization, security, performance tuning, and administration with structured, actionable advice and official references.

C
Claude Directory