How We Structure Large-Scale React Projects

The problem with "just start coding"

Small React projects are forgiving. At a hundred components, a flat folder becomes a maze.

Feature-based organisation

src/
  features/
    auth/
      components/
      hooks/
      api.ts
      index.ts
    dashboard/
  shared/
    components/
    hooks/
    utils/

Other conventions we follow

• Co-locate tests with the code they test
• Custom hooks over bloated components (>150 lines is a signal)
• Absolute imports via tsconfig paths: @/features/auth