# emersonbraun/react-clean-arch architecture

> Architecture diagram of the GitHub repository emersonbraun/react-clean-arch, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/emersonbraun/react-clean-arch
- Repository: https://github.com/emersonbraun/react-clean-arch

## Overview

This React application lets a user view and edit a profile, inspect membership features, list users, and request an eligible premium upgrade. The profile page is the documented entry point; hooks resolve use cases through the container, which wires application operations to a repository and analytics service. Domain entities enforce user rules, while use cases produce profile data and perform updates/upgrades. The repository implementation is an in-memory, Faker-seeded store despite its Http name. Edges reflect shown source references and explicit README capabilities; unsampled feature internals are represented at their exact directories.

Main entry points: [`src/infrastructure/config/container.ts`](https://github.com/emersonbraun/react-clean-arch/blob/master/src/infrastructure/config/container.ts) (DI container), [`src/ui/hooks`](https://github.com/emersonbraun/react-clean-arch/tree/master/src/ui/hooks) (Profile hooks), [`src/application/use-cases/GetUserProfile.ts`](https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/use-cases/GetUserProfile.ts) (View profile), [`src/application/use-cases/UpgradeMembership.ts`](https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/use-cases/UpgradeMembership.ts) (Upgrade membership)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Presentation"]
  node_app["App shell<br/>[App.tsx]"]
  node_profile_page["Profile page"]
  node_profile_hooks["Profile hooks"]
  node_edit_form["Edit form"]
  node_membership_ui["Membership UI"]
  node_validation_hook["Form validation"]
  node_container_provider["Container provider"]
end

subgraph group_application["Application"]
  node_profile_usecase["View profile<br/>[GetUserProfile.ts]"]
  node_list_usecase["List users<br/>[ListUsers.ts]"]
  node_update_usecase["Update profile"]
  node_upgrade_usecase["Upgrade membership"]
  node_profile_dto["Profile DTO<br/>[UserProfileDto.ts]"]
  node_validation_service["Validation service"]
end

subgraph group_domain["Domain"]
  node_user_entity["User rules<br/>[User.ts]"]
  node_profile_validation["Profile validation"]
  node_repository_contract["User repository contract<br/>[UserRepository.ts]"]
end

subgraph group_infrastructure["Infrastructure"]
  node_container["DI container<br/>[container.ts]"]
  node_user_repository[("User store")]
  node_analytics["Analytics service"]
end

node_user(("End user"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_profile_page
node_app -->|"provides"| node_container_provider
node_profile_page -->|"uses"| node_profile_hooks
node_profile_page -->|"renders"| node_edit_form
node_profile_page -->|"renders"| node_membership_ui
node_edit_form -->|"validates with"| node_validation_hook
node_validation_hook -->|"delegates to"| node_validation_service
node_profile_hooks -->|"resolves through"| node_container_provider
node_profile_hooks -->|"executes"| node_profile_usecase
node_profile_hooks -->|"executes"| node_list_usecase
node_profile_hooks -->|"executes"| node_update_usecase
node_profile_hooks -->|"executes"| node_upgrade_usecase
node_container_provider -->|"exposes"| node_container
node_container -->|"registers"| node_profile_usecase
node_container -->|"registers"| node_list_usecase
node_container -->|"registers"| node_update_usecase
node_container -->|"registers"| node_upgrade_usecase
node_container -->|"registers"| node_user_repository
node_container -->|"registers"| node_analytics
node_profile_usecase -->|"reads"| node_repository_contract
node_list_usecase -->|"queries"| node_repository_contract
node_update_usecase -->|"reads and saves"| node_repository_contract
node_upgrade_usecase -->|"reads and saves"| node_repository_contract
node_user_repository -->|"implements"| node_repository_contract
node_user_repository -->|"creates"| node_user_entity
node_profile_usecase -->|"returns"| node_profile_dto
node_profile_usecase -->|"derives profile from"| node_user_entity
node_update_usecase -->|"constructs"| node_user_entity
node_upgrade_usecase -->|"checks and constructs"| node_user_entity
node_validation_service -->|"uses rules"| node_profile_validation
node_profile_usecase -->|"tracks events"| node_analytics
node_upgrade_usecase -->|"tracks events"| node_analytics

click node_app "https://github.com/emersonbraun/react-clean-arch/blob/master/src/App.tsx"
click node_profile_page "https://github.com/emersonbraun/react-clean-arch/blob/master/src/ui/pages/UserProfilePage.tsx"
click node_profile_hooks "https://github.com/emersonbraun/react-clean-arch/tree/master/src/ui/hooks"
click node_edit_form "https://github.com/emersonbraun/react-clean-arch/blob/master/src/ui/components/UserProfile/EditProfileForm.tsx"
click node_membership_ui "https://github.com/emersonbraun/react-clean-arch/tree/master/src/ui/components/UserProfile"
click node_validation_hook "https://github.com/emersonbraun/react-clean-arch/blob/master/src/ui/hooks/useFormValidation.ts"
click node_container_provider "https://github.com/emersonbraun/react-clean-arch/blob/master/src/ui/providers/ContainerProvider.tsx"
click node_profile_usecase "https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/use-cases/GetUserProfile.ts"
click node_list_usecase "https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/use-cases/ListUsers.ts"
click node_update_usecase "https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/use-cases/UpdateUserProfile.ts"
click node_upgrade_usecase "https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/use-cases/UpgradeMembership.ts"
click node_profile_dto "https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/dto/UserProfileDto.ts"
click node_validation_service "https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/services/FormValidationService.ts"
click node_user_entity "https://github.com/emersonbraun/react-clean-arch/blob/master/src/domain/entities/User.ts"
click node_profile_validation "https://github.com/emersonbraun/react-clean-arch/blob/master/src/domain/entities/UserProfileValidation.ts"
click node_repository_contract "https://github.com/emersonbraun/react-clean-arch/blob/master/src/domain/repositories/UserRepository.ts"
click node_container "https://github.com/emersonbraun/react-clean-arch/blob/master/src/infrastructure/config/container.ts"
click node_user_repository "https://github.com/emersonbraun/react-clean-arch/blob/master/src/infrastructure/repositories/HttpUserRepository.ts"
click node_analytics "https://github.com/emersonbraun/react-clean-arch/blob/master/src/infrastructure/services/AnalyticsService.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_profile_page,node_profile_hooks,node_edit_form,node_membership_ui,node_validation_hook,node_container_provider,node_user toneBlue
class node_profile_usecase,node_list_usecase,node_update_usecase,node_upgrade_usecase,node_profile_dto,node_validation_service toneAmber
class node_user_entity,node_profile_validation,node_repository_contract toneMint
class node_container,node_user_repository,node_analytics toneRose
```

## Components

### Presentation

- [App shell](https://github.com/emersonbraun/react-clean-arch/blob/master/src/App.tsx): `src/App.tsx`
- [Profile page](https://github.com/emersonbraun/react-clean-arch/blob/master/src/ui/pages/UserProfilePage.tsx): `src/ui/pages/UserProfilePage.tsx`
- [Profile hooks](https://github.com/emersonbraun/react-clean-arch/tree/master/src/ui/hooks): `src/ui/hooks`
- [Edit form](https://github.com/emersonbraun/react-clean-arch/blob/master/src/ui/components/UserProfile/EditProfileForm.tsx): `src/ui/components/UserProfile/EditProfileForm.tsx`
- [Membership UI](https://github.com/emersonbraun/react-clean-arch/tree/master/src/ui/components/UserProfile): `src/ui/components/UserProfile`
- [Form validation](https://github.com/emersonbraun/react-clean-arch/blob/master/src/ui/hooks/useFormValidation.ts): `src/ui/hooks/useFormValidation.ts`
- [Container provider](https://github.com/emersonbraun/react-clean-arch/blob/master/src/ui/providers/ContainerProvider.tsx): `src/ui/providers/ContainerProvider.tsx`

### Application

- [View profile](https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/use-cases/GetUserProfile.ts): `src/application/use-cases/GetUserProfile.ts`
- [List users](https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/use-cases/ListUsers.ts): `src/application/use-cases/ListUsers.ts`
- [Update profile](https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/use-cases/UpdateUserProfile.ts): `src/application/use-cases/UpdateUserProfile.ts`
- [Upgrade membership](https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/use-cases/UpgradeMembership.ts): `src/application/use-cases/UpgradeMembership.ts`
- [Profile DTO](https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/dto/UserProfileDto.ts): `src/application/dto/UserProfileDto.ts`
- [Validation service](https://github.com/emersonbraun/react-clean-arch/blob/master/src/application/services/FormValidationService.ts): `src/application/services/FormValidationService.ts`

### Domain

- [User rules](https://github.com/emersonbraun/react-clean-arch/blob/master/src/domain/entities/User.ts): `src/domain/entities/User.ts`
- [Profile validation](https://github.com/emersonbraun/react-clean-arch/blob/master/src/domain/entities/UserProfileValidation.ts): `src/domain/entities/UserProfileValidation.ts`
- [User repository contract](https://github.com/emersonbraun/react-clean-arch/blob/master/src/domain/repositories/UserRepository.ts): `src/domain/repositories/UserRepository.ts`

### Infrastructure

- [DI container](https://github.com/emersonbraun/react-clean-arch/blob/master/src/infrastructure/config/container.ts): `src/infrastructure/config/container.ts`
- [User store](https://github.com/emersonbraun/react-clean-arch/blob/master/src/infrastructure/repositories/HttpUserRepository.ts): `src/infrastructure/repositories/HttpUserRepository.ts`
- [Analytics service](https://github.com/emersonbraun/react-clean-arch/blob/master/src/infrastructure/services/AnalyticsService.ts): `src/infrastructure/services/AnalyticsService.ts`

### Other components

- **End user**

## Connections

- End user → App shell: uses (evidence: `src/App.tsx`)
- App shell → Profile page: renders (evidence: `src/App.tsx`)
- App shell → Container provider: provides (evidence: `src/App.tsx`)
- Profile page → Profile hooks: uses (evidence: `src/ui/pages/UserProfilePage.tsx`)
- Profile page → Edit form: renders (evidence: `src/ui/pages/UserProfilePage.tsx`)
- Profile page → Membership UI: renders (evidence: `src/ui/pages/UserProfilePage.tsx`)
- Edit form → Form validation: validates with (evidence: `src/ui/components/UserProfile/EditProfileForm.tsx`)
- Form validation → Validation service: delegates to (evidence: `src/ui/hooks/useFormValidation.ts`)
- Profile hooks → Container provider: resolves through (evidence: `src/ui/hooks/useUserProfile.ts`)
- Profile hooks → View profile: executes (evidence: `src/ui/hooks/useUserProfile.ts`)
- Profile hooks → List users: executes (evidence: `src/ui/hooks/useListUsers.ts`)
- Profile hooks → Update profile: executes (evidence: `src/ui/hooks/useUpdateUserProfile.ts`)
- Profile hooks → Upgrade membership: executes (evidence: `src/ui/hooks/useUpgradeMembership.ts`)
- Container provider → DI container: exposes (evidence: `src/ui/providers/ContainerProvider.tsx`)
- DI container → View profile: registers (evidence: `src/infrastructure/config/container.ts`)
- DI container → List users: registers (evidence: `src/infrastructure/config/container.ts`)
- DI container → Update profile: registers (evidence: `src/infrastructure/config/container.ts`)
- DI container → Upgrade membership: registers (evidence: `src/infrastructure/config/container.ts`)
- DI container → User store: registers (evidence: `src/infrastructure/config/container.ts`)
- DI container → Analytics service: registers (evidence: `src/infrastructure/config/container.ts`)
- View profile → User repository contract: reads (evidence: `src/application/use-cases/GetUserProfile.ts`)
- List users → User repository contract: queries (evidence: `src/application/use-cases/ListUsers.ts`)
- Update profile → User repository contract: reads and saves (evidence: `src/application/use-cases/UpdateUserProfile.ts`)
- Upgrade membership → User repository contract: reads and saves (evidence: `src/application/use-cases/UpgradeMembership.ts`)
- User store → User repository contract: implements (evidence: `src/infrastructure/repositories/HttpUserRepository.ts`)
- User store → User rules: creates (evidence: `src/infrastructure/repositories/HttpUserRepository.ts`)
- View profile → Profile DTO: returns (evidence: `src/application/use-cases/GetUserProfile.ts`)
- View profile → User rules: derives profile from (evidence: `src/application/use-cases/GetUserProfile.ts`)
- Update profile → User rules: constructs (evidence: `src/application/use-cases/UpdateUserProfile.ts`)
- Upgrade membership → User rules: checks and constructs (evidence: `src/application/use-cases/UpgradeMembership.ts`)
- Validation service → Profile validation: uses rules (evidence: `src/application/services/FormValidationService.ts`)
- View profile → Analytics service: tracks events (evidence: `src/application/use-cases/GetUserProfile.ts`)
- Upgrade membership → Analytics service: tracks events (evidence: `src/application/use-cases/UpgradeMembership.ts`)
