TypeScript Coding Conventions

General Principles

• Use TypeScript strict mode ("strict": true in tsconfig.json).
• Prefer const over let; never use var.
• Use explicit return types on exported functions.
• Prefer interfaces over type aliases for object shapes.
• Use unknown instead of any where possible.

Naming Conventions

• Variables & functions: camelCase
• Classes & interfaces: PascalCase
• Constants: UPPER_SNAKE_CASE for true constants, camelCase for derived values
• Files: kebab-case.ts
• Type parameters: Single uppercase letter (T, K, V) or descriptive (TResult)

File Structure