T3 App Boilerplate

Key Features

Core Features

tRPC Benefits

• ✅ No code generation - Types inferred automatically
• ✅ Auto-complete - Full IDE support
• ✅ Type safety - Catch errors at compile time
• ✅ No GraphQL - Simple RPC-style API

Quick Start

# Create new T3 app
npx create-t3-app@latest

# Or use existing boilerplate
cd t3-app-boilerplate
npm install

# Setup environment
cp .env.example .env

# Run migrations
npx prisma migrate dev

# Start development
npm run dev

Project Structure

t3-app/
├── src/
│   ├── app/              # Next.js App Router
│   ├── server/
│   │   ├── api/          # tRPC routers
│   │   ├── db/           # Prisma client
│   │   └── auth/         # NextAuth config
│   ├── components/       # React components
│   ├── styles/           # Global styles
│   └── utils/            # Utilities
├── prisma/
│   └── schema.prisma     # Database schema
└── package.json

Usage Examples

tRPC Router

// server/api/routers/posts.ts
import { router, publicProcedure } from '../trpc';

export const postsRouter = router({
  all: publicProcedure.query(async ({ ctx }) => {
    return ctx.db.post.findMany();
  }),
  
  byId: publicProcedure
    .input(z.object({ id: z.string() }))
    .query(async ({ ctx, input }) => {
      return ctx.db.post.findUnique({
        where: { id: input.id }
      });
    }),
});

React Component

// Using tRPC hook
const { data: posts } = api.posts.all.useQuery();

// Mutation
const createPost = api.posts.create.useMutation({
  onSuccess: () => {
    utils.posts.all.invalidate();
  }
});

Prisma Schema

model Post {
  id        String   @id @default(cuid())
  title     String
  content   String?
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
  author    User     @relation(fields: [authorId], references: [id])
  authorId  String
}

For AI Assistants

When helping with T3 projects:

1. Understand tRPC - It's not REST or GraphQL
2. Type inference - No manual type definitions needed
3. Prisma patterns - Know common queries
4. NextAuth setup - Configure providers
5. Deployment - Environment variables

Best Practices

• Type everything - Let TypeScript infer
• Server components - Use where possible
• Validate input - Always use Zod
• Error handling - tRPC error types
• Testing - Vitest for tRPC routers

Related Skills

• saas-boilerplate-ixartz - Alternative SaaS starter
• awesome-python - Python backend alternative
• sst - Serverless deployment

Repository Location

C:\Users\user\.qwen\skills\t3-app-boilerplate

Source