TypeScript + React Standards

Strict, reusable standards for TypeScript/React projects.

When to Use

Use this skill when:

• Writing or refactoring .ts / .tsx
• Moving inline types into types/
• Enforcing consistent type naming and result shapes
• Working in Next.js where special files allow extra exports

Non-Negotiables (MUST)

• One exported symbol per file for your own modules.
• No inline interface/type in components/hooks/utils/services/route
  handlers.
• Put shared shapes under types/<area>/... (one type per file).
• Avoid barrel files (index.ts) that hide dependencies.
• After meaningful changes: run the project's standard checks (e.g.
  yarn check:all).

Next.js Special-file Exceptions

• app/**/page.tsx, app/**/layout.tsx: allow default export +
  metadata/generateMetadata/viewport (etc.).
• app/api/**/route.ts: allow multiple HTTP method exports and route config
  exports.

Rules

TypeScript Standards

• ts-language-style - Language & style (interface vs type, const vs let,
  English-only)
• ts-one-thing-per-file - One thing per file (STRICT)
• ts-nextjs-exceptions - Next.js special-file exceptions
• ts-types-strict - Types (STRICT) - no inline types
• ts-helpers-strict - Helpers (STRICT) - no helpers in components/hooks
• ts-nextjs-hygiene - Next.js TS hygiene (docs-aligned)
• ts-validation - Validation (run checks after changes)

Types Conventions

• types-one-type-per-file - One type per file (STRICT)
• types-naming-patterns - Naming patterns (Params, Result, Error, Props)
• types-result-shape - Result shape for boundaries that can fail
• types-where-allowed - Where types are allowed

Related Skills

• busirocket-core-conventions - General file structure (one-thing-per-file,
  boundaries)
• busirocket-react - Component and hook structure
• busirocket-refactor-workflow - Refactoring workflow for TypeScript/React

How to Use

Read individual rule files for detailed explanations and code examples:

rules/ts-one-thing-per-file.md
rules/ts-types-strict.md
rules/types-one-type-per-file.md

Each rule file contains:

• Brief explanation of why it matters
• Code examples (correct and incorrect patterns)
• Additional context and best practices