tRPC Skill
Expert assistance for building type-safe APIs with tRPC.
Capabilities
- Create type-safe procedures and routers
- Implement middleware for auth/validation
- Set up tRPC with Next.js/React
- Handle subscriptions
- Configure error handling
- Build type-safe client hooks
Usage
Invoke this skill when you need to:
- Build end-to-end type-safe APIs
- Integrate with React/Next.js
- Replace REST with type-safe RPC
- Implement real-time features
Patterns
Router Definition
// server/trpc/routers/user.ts
import { z } from 'zod';
import { router, publicProcedure, protectedProcedure } from '../trpc';
import { TRPCError } from '@trpc/server';
export const userRouter = router({
list: protectedProcedure
.input(z.object({
page: z.number().min(1).default(1),
limit: z.number().min(1).max(100).default(10),
search: z.string().optional(),
}))
.query(async ({ ctx, input }) => {
const users = await ctx.prisma.user.findMany({
where: input.search
? { name: { contains: input.search } }
: undefined,
skip: (input.page - 1) * input.limit,
take: input.limit,
});
return users;
}),
byId: protectedProcedure
.input(z.string())
.query(async ({ ctx, input }) => {
const user = await ctx.prisma.user.findUnique({
where: { id: input },
});
if (!user) {
throw new TRPCError({ code: 'NOT_FOUND' });
}
return user;
}),
create: protectedProcedure
.input(z.object({
name: z.string().min(1),
email: z.string().email(),
}))
.mutation(async ({ ctx, input }) => {
return ctx.prisma.user.create({ data: input });
}),
});
React Integration
// In component
const { data, isLoading } = trpc.user.list.useQuery({ page: 1 });
const createUser = trpc.user.create.useMutation();
<button => createUser.mutate({ name, email })}>
Create
</button>
Best Practices
- Use Zod for input validation
- Implement proper middleware
- Leverage type inference
- Handle errors consistently
Target Processes
- t3-stack-development
- nextjs-full-stack
- type-safe-api
1---2name: trpc3description: tRPC end-to-end type safety, procedures, routers, middleware, and React integration.4allowed-tools: Read, Write, Edit, Bash, Glob, Grep5metadata:6 source: https://skillmd.com/skills/majiayu000/trpc7---89# tRPC Skill1011Expert assistance for building type-safe APIs with tRPC.1213## Capabilities1415- Create type-safe procedures and routers16- Implement middleware for auth/validation17- Set up tRPC with Next.js/React18- Handle subscriptions19- Configure error handling20- Build type-safe client hooks2122## Usage2324Invoke this skill when you need to:25- Build end-to-end type-safe APIs26- Integrate with React/Next.js27- Replace REST with type-safe RPC28- Implement real-time features2930## Patterns3132### Router Definition3334```typescript35// server/trpc/routers/user.ts36import { z } from 'zod';37import { router, publicProcedure, protectedProcedure } from '../trpc';38import { TRPCError } from '@trpc/server';3940export const userRouter = router({41 list: protectedProcedure42 .input(z.object({43 page: z.number().min(1).default(1),44 limit: z.number().min(1).max(100).default(10),45 search: z.string().optional(),46 }))47 .query(async ({ ctx, input }) => {48 const users = await ctx.prisma.user.findMany({49 where: input.search50 ? { name: { contains: input.search } }51 : undefined,52 skip: (input.page - 1) * input.limit,53 take: input.limit,54 });55 return users;56 }),5758 byId: protectedProcedure59 .input(z.string())60 .query(async ({ ctx, input }) => {61 const user = await ctx.prisma.user.findUnique({62 where: { id: input },63 });64 if (!user) {65 throw new TRPCError({ code: 'NOT_FOUND' });66 }67 return user;68 }),6970 create: protectedProcedure71 .input(z.object({72 name: z.string().min(1),73 email: z.string().email(),74 }))75 .mutation(async ({ ctx, input }) => {76 return ctx.prisma.user.create({ data: input });77 }),78});79```8081### React Integration8283```typescript84// In component85const { data, isLoading } = trpc.user.list.useQuery({ page: 1 });86const createUser = trpc.user.create.useMutation();8788<button onClick={() => createUser.mutate({ name, email })}>89 Create90</button>91```9293## Best Practices9495- Use Zod for input validation96- Implement proper middleware97- Leverage type inference98- Handle errors consistently99100## Target Processes101102- t3-stack-development103- nextjs-full-stack104- type-safe-api