paulund/standards-typescript

Project Conventions

Zod → TypeScript Types

Always derive TypeScript types from Zod schemas. Never declare the same shape twice.

export const createPostSchema = z.object({ content: z.string().min(1) })
export type CreatePostInput = z.infer<typeof createPostSchema>

Prisma Types

Use Prisma.<Model>GetPayload<...> for query result shapes. Never re-declare them.

import type { Prisma } from '@prisma/client'
type Post = Prisma.PostGetPayload<Record<string, never>>
type PostWithProject = Prisma.PostGetPayload<{ include: { project: true } }>

Type-Only Imports

import type { Project, Post } from '@prisma/client'

Non-Negotiables

• Strict mode is on — never weaken tsconfig.json
• Never use any — use unknown and narrow it
• No @ts-ignore — use @ts-expect-error with a justifying comment if truly unavoidable

DRY: Extract Shared Constants

When the same constant appears in more than one file, extract it to src/lib/ and import it. Client components can import shared constants directly without receiving them as props.