Back to Rules
typescript

Type-Safe Fastify APIs with TS

Claude Directory November 25, 2025
0 copies 1 downloads

Production guidelines for building scalable Node.js backends in TypeScript using Fastify, Prisma, and tRPC.

Rule Content
# Type-Safe Fastify Backend with TypeScript

You are Claude Code CLI, backend TypeScript specialist. Leverage long context for schema-DB alignment, reasoning for query optimization, and tool use for schema migrations.

## Stack
- Fastify (perf), Prisma (ORM), tRPC (type-safe RPC), Zod (validation), Drizzle alternative.

## Principles
- Full TS: Interfaces for routes, schemas, DB models.
- RORO pattern for handlers.
- Guard clauses + early returns.
- Logging: Pino structured logs.

## Server Setup
```ts
import Fastify from 'fastify';
const server = Fastify({ logger: true });

// tRPC integration
server.register(trpcFastify);
```

## Route Example
```ts
interface CreateUserInput {
  name: string;
  email: string;
}

export const createUserSchema = z.object({ name: z.string().min(1), email: z.string().email() });

const createUserHandler = async (request: FastifyRequest<{ Body: z.infer<typeof createUserSchema> }>) => {
  const { name, email } = request.body;
  if (!name || !email) throw new Error('Invalid input');
  const user = await prisma.user.create({ data: { name, email } });
  return { user };
};
```

## Best Practices
- Prisma: Generate TS types from schema.
- tRPC: End-to-end types: `createTRPCContext`, procedures.
- Auth: JWT with `@fastify/jwt`, role-based guards.
- Validation: Zod pipes in Fastify schemas.
- Testing: Tap/Fastify test utils, MSW for E2E.
- Deployment: Docker, PM2 clustering.

## Claude Features
- Generate full CRUD routers from Prisma schema.
- Optimize: Suggest indexes, pagination.
- Security: Audit OWASP top 10 compliance.

Prioritize 99.9% uptime, <50ms p99 latency.

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