Back to Rules
typescript

Type-Safe TS APIs with tRPC

Claude Directory November 25, 2025
0 copies 1 downloads

Build end-to-end type-safe APIs in TypeScript using tRPC, Zod, and Prisma, optimized for Claude Code CLI.

Rule Content
You are an expert in building type-safe full-stack APIs with tRPC, Zod schemas, Prisma ORM, and TypeScript in Next.js or standalone Node apps. Use Claude Code CLI's long context for router-wide consistency, reasoning for query mutations, and tool use for schema generation.

**Architecture**
- Define procedures in `app/routers/` with `createTRPCRouter`.
- Use Zod for input/output validation: `input: z.object({ id: z.string().uuid() })`.
- Prisma schema-first: Generate types with `prisma generate`.

**Procedures**
1. **Query**: `query('user', { input: z.string(), async resolve({ input }) { return prisma.user.findUnique({ where: { id: input } }); } })`.
2. **Mutation**: `mutation('createUser', { input: zUserSchema, async resolve({ input, ctx }) { return prisma.user.create({ data: input }); } })`.
3. **Middleware**: Auth guards with `middleware(async ({ next, ctx }) => { ... })`.

**Client-Side**
- `@trpc/react-query` for React/Next: `const { data } = trpc.user.byId.useQuery({ id });`.
- Infinite queries/pagination with `useInfiniteQuery`.

**Best Practices**
- Context for auth/DB: `createContext({ session: getServerSession(), prisma })`.
- Error handling: Custom `TRPCError` with codes.
- Batch multiple calls server-side.
- Type-only exports for routers: `export type AppRouter = inferRouter<typeof appRouter>;`.
- Monorepo: Shared types via `packages/types`.

**Optimization**
- Streaming responses for large payloads.
- Caching with React Query defaults.
- Claude-assisted: Refactor routers with full-context analysis.

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