react-architecture

Standardize React project structure with Vite and TypeScript conventions.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/tassosgomes/poc-iam-service --skill react-architecture-tassosgomes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: react-architecture
Source: https://github.com/tassosgomes/poc-iam-service/tree/main/.github/skills/react/react-architecture
Command: npx skills add https://github.com/tassosgomes/poc-iam-service --skill react-architecture-tassosgomes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill codifies architectural standards for React projects (Vite + TS) to reduce onboarding time, improve maintainability, and align multiple teams around consistent structure and import conventions.

Core Features & Use Cases

  • Defines the project structure for small-to-medium React apps, including top-level folders like src, components, features, hooks, utils.
  • Enforces naming conventions: kebab-case folders, PascalCase component files, and index.ts public APIs.
  • Guides onboarding, PR reviews, and refactors to maintain consistent architecture across modules.

Quick Start

Create a new React project (Vite + TypeScript) following the standard architecture to initialize a clean, scalable codebase.

Frequently Asked Questions about react-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize React project architecture to reduce chaos in a multi-team environment?

Standardize React project architecture by enforcing folder naming, public API surfaces via index.ts, and alias-based imports. This reduces onboarding time, improves maintainability, and aligns multiple teams around consistent folder conventions and import structures.

What is the best way to structure a new Vite and TypeScript React project?

The best way to structure a new Vite and TypeScript React project is by defining top-level folders like src, components, features, hooks, and utils. Enforce kebab-case folders, PascalCase component files, and index.ts public APIs to initialize a clean, scalable codebase.

How do I configure import aliases in a React Vite project?

Configure import aliases in a React Vite project by enforcing alias-based imports instead of relative paths. This architectural standard separates UI, domain logic, and features while improving code readability and maintaining consistent import conventions across modules.

Can I use this React architecture standard for PR reviews requiring folder conventions?

Yes, you can use this React architecture standard for PR reviews requiring folder conventions. It codifies structural standards including kebab-case folders, PascalCase component files, and index.ts public APIs to guide PR reviews and maintain consistent architecture across modules.

Why do I need an index.ts public API surface in my React features?

You need an index.ts public API surface in your React features to enforce strict module boundaries and separation of UI, domain logic, and features. This architectural standard ensures consistent structure, reduces chaos, and streamlines refactoring across multi-team environments.

When should I not use a standardized React folder structure?

You should not use a standardized React folder structure if your project does not use Vite and TypeScript or if it is a large-scale application exceeding the small-to-medium app scope. This architecture targets specific folder conventions and import aliases for that defined scale.