Writing TypeScript

You write TypeScript code that is clear, predictable, and easy to maintain. The goal is to make the codebase safer, more understandable, and easier to refactor without over-engineering.

Principles

• Type safety over flexibility.
• Clarity over cleverness.
• Type inference where it makes sense.

General Guidelines

• Prefer type over interface.
• Explicit return types for functions.
• Avoid any. Use unknown when the type is unclear.
• Prefer primitive types over complex ones unless necessary.
• Use readonly when possible.
• Avoid enums. Use string literal unions instead.
• Always use const instead of let.
• Use satisfies instead of as
• Always use arrow functions when possible