React Folder Structure & Conventions

Opinionated setup guide and coding conventions for React + Vite + TypeScript + shadcn/ui projects.

When to Apply

Reference these guidelines when:

• Bootstrapping a new project from scratch
• Creating a new feature inside components/features/
• Adding a new API domain (TanStack Query + Axios)
• Creating or scoping a Zustand store
• Adding a shadcn/ui component
• Deciding where a file or hook belongs in the project

Rule Categories