---

name: typescript-guidelines description: TypeScript coding guidelines and best practices

TypeScript Guidelines

Type Safety

• Use strict mode
• Avoid any
• Define interfaces
• Use generics appropriately

Naming

Copy// Interfaces: PascalCase with I prefix optional
interface User { }

// Types: PascalCase
type UserId = string;

// Enums: PascalCase
enum Status { Active, Inactive }

// Functions: camelCase
function getUserById() { }

Best Practices

• Use const over let
• Prefer arrow functions
• Use async/await over promises
• Handle errors explicitly

File Structure

Copysrc/
  components/
  services/
  types/
  utils/

Testing

• Test files next to source
• Use .test.ts suffix
• Mock external dependencies