# alan2207/bulletproof-react architecture

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

- Interactive diagram: https://gitdiagram.com/alan2207/bulletproof-react
- Repository: https://github.com/alan2207/bulletproof-react

## Overview

Bulletproof React is an architecture guide demonstrated through three sample applications: Next.js App Router, Next.js Pages Router, and React Vite. A user enters through a landing or authentication route, then reaches protected application areas for discussions, profiles, dashboards, and user administration. The tree documents feature APIs and UI components across all three variants. Excerpts establish Vite route dispatch and selected Next.js page composition; other connections are left out where source evidence was not provided.

Main entry points: [`apps/react-vite/src/app/router.tsx`](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/router.tsx) (Vite Route Dispatcher), [`apps/react-vite/src/app/routes/landing.tsx`](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/routes/landing.tsx) (Landing Page), [`apps/nextjs-app/src/app`](https://github.com/alan2207/bulletproof-react/tree/master/apps/nextjs-app/src/app) (App Router Pages), [`apps/react-vite/src/app/routes/auth`](https://github.com/alan2207/bulletproof-react/tree/master/apps/react-vite/src/app/routes/auth) (Login and Registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and Routing"]
  node_vite_bootstrap["Vite App Bootstrap<br/>[index.tsx]"]
  node_vite_router["Vite Route Dispatcher<br/>[router.tsx]"]
  node_vite_landing["Landing Page<br/>[landing.tsx]"]
  node_next_app_pages["App Router Pages"]
  node_next_pages_pages["Pages Router"]
end

subgraph group_identity["Identity and Access"]
  node_login["Login and Registration"]
  node_auth_lib["Authentication State<br/>[auth.tsx]"]
  node_admin_guard["Admin Guard<br/>[admin-guard.tsx]"]
end

subgraph group_features["Product Features"]
  node_dashboard["Dashboard<br/>[dashboard.tsx]"]
  node_discussions["Discussions<br/>[discussions.tsx]"]
  node_discussion_detail["Discussion Detail<br/>[page.tsx]"]
  node_comments["Comments<br/>[comments.tsx]"]
  node_profile["User Profile<br/>[profile.tsx]"]
  node_users["User Administration<br/>[users.tsx]"]
  node_api_features["Feature API Modules"]
end

subgraph group_foundation["Shared App Foundation"]
  node_api_client["API Client<br/>[api-client.ts]"]
  node_query_state["Query State<br/>[react-query.ts]"]
  node_ui_components["UI Components"]
end

node_engineer(("User"))

node_engineer -->|"opens"| node_vite_landing
node_vite_bootstrap -->|"renders"| node_vite_router
node_vite_router -->|"routes to"| node_vite_landing
node_vite_router -->|"routes to"| node_login
node_vite_router -->|"routes to"| node_dashboard
node_vite_landing -->|"navigates"| node_dashboard
node_vite_landing -->|"navigates"| node_login
node_next_app_pages -->|"renders"| node_discussions
node_next_app_pages -->|"wraps"| node_admin_guard
node_next_app_pages -->|"renders"| node_users

click node_vite_bootstrap "https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/index.tsx"
click node_vite_router "https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/router.tsx"
click node_vite_landing "https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/routes/landing.tsx"
click node_next_app_pages "https://github.com/alan2207/bulletproof-react/tree/master/apps/nextjs-app/src/app"
click node_next_pages_pages "https://github.com/alan2207/bulletproof-react/tree/master/apps/nextjs-pages/src/pages"
click node_login "https://github.com/alan2207/bulletproof-react/tree/master/apps/react-vite/src/app/routes/auth"
click node_auth_lib "https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/lib/auth.tsx"
click node_admin_guard "https://github.com/alan2207/bulletproof-react/blob/master/apps/nextjs-app/src/app/app/users/_components/admin-guard.tsx"
click node_dashboard "https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/routes/app/dashboard.tsx"
click node_discussions "https://github.com/alan2207/bulletproof-react/blob/master/apps/nextjs-app/src/app/app/discussions/_components/discussions.tsx"
click node_discussion_detail "https://github.com/alan2207/bulletproof-react/blob/master/apps/nextjs-app/src/app/app/discussions/%5BdiscussionId%5D/page.tsx"
click node_comments "https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/features/comments/components/comments.tsx"
click node_profile "https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/routes/app/profile.tsx"
click node_users "https://github.com/alan2207/bulletproof-react/blob/master/apps/nextjs-app/src/app/app/users/_components/users.tsx"
click node_api_features "https://github.com/alan2207/bulletproof-react/tree/master/apps/react-vite/src/features"
click node_api_client "https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/lib/api-client.ts"
click node_query_state "https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/lib/react-query.ts"
click node_ui_components "https://github.com/alan2207/bulletproof-react/tree/master/apps/react-vite/src/components/ui"

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_vite_bootstrap,node_vite_router,node_vite_landing,node_next_app_pages,node_next_pages_pages,node_engineer toneBlue
class node_login,node_auth_lib,node_admin_guard toneAmber
class node_dashboard,node_discussions,node_discussion_detail,node_comments,node_profile,node_users,node_api_features toneMint
class node_api_client,node_query_state,node_ui_components toneRose
```

## Components

### Entry and Routing

- [Vite App Bootstrap](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/index.tsx): `apps/react-vite/src/app/index.tsx`
- [Vite Route Dispatcher](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/router.tsx): `apps/react-vite/src/app/router.tsx`
- [Landing Page](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/routes/landing.tsx): `apps/react-vite/src/app/routes/landing.tsx`
- [App Router Pages](https://github.com/alan2207/bulletproof-react/tree/master/apps/nextjs-app/src/app): `apps/nextjs-app/src/app`
- [Pages Router](https://github.com/alan2207/bulletproof-react/tree/master/apps/nextjs-pages/src/pages): `apps/nextjs-pages/src/pages`

### Identity and Access

- [Login and Registration](https://github.com/alan2207/bulletproof-react/tree/master/apps/react-vite/src/app/routes/auth): `apps/react-vite/src/app/routes/auth`
- [Authentication State](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/lib/auth.tsx): `apps/react-vite/src/lib/auth.tsx`
- [Admin Guard](https://github.com/alan2207/bulletproof-react/blob/master/apps/nextjs-app/src/app/app/users/_components/admin-guard.tsx): `apps/nextjs-app/src/app/app/users/_components/admin-guard.tsx`

### Product Features

- [Dashboard](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/routes/app/dashboard.tsx): `apps/react-vite/src/app/routes/app/dashboard.tsx`
- [Discussions](https://github.com/alan2207/bulletproof-react/blob/master/apps/nextjs-app/src/app/app/discussions/_components/discussions.tsx): `apps/nextjs-app/src/app/app/discussions/_components/discussions.tsx`
- [Discussion Detail](https://github.com/alan2207/bulletproof-react/blob/master/apps/nextjs-app/src/app/app/discussions/%5BdiscussionId%5D/page.tsx): `apps/nextjs-app/src/app/app/discussions/[discussionId]/page.tsx`
- [Comments](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/features/comments/components/comments.tsx): `apps/react-vite/src/features/comments/components/comments.tsx`
- [User Profile](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/app/routes/app/profile.tsx): `apps/react-vite/src/app/routes/app/profile.tsx`
- [User Administration](https://github.com/alan2207/bulletproof-react/blob/master/apps/nextjs-app/src/app/app/users/_components/users.tsx): `apps/nextjs-app/src/app/app/users/_components/users.tsx`
- [Feature API Modules](https://github.com/alan2207/bulletproof-react/tree/master/apps/react-vite/src/features): `apps/react-vite/src/features`

### Shared App Foundation

- [API Client](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/lib/api-client.ts): `apps/react-vite/src/lib/api-client.ts`
- [Query State](https://github.com/alan2207/bulletproof-react/blob/master/apps/react-vite/src/lib/react-query.ts): `apps/react-vite/src/lib/react-query.ts`
- [UI Components](https://github.com/alan2207/bulletproof-react/tree/master/apps/react-vite/src/components/ui): `apps/react-vite/src/components/ui`

### Other components

- **User**

## Connections

- User → Landing Page: opens (evidence: `apps/react-vite/src/app/routes/landing.tsx`)
- Vite App Bootstrap → Vite Route Dispatcher: renders (evidence: `apps/react-vite/src/app/index.tsx`)
- Vite Route Dispatcher → Landing Page: routes to (evidence: `apps/react-vite/src/app/router.tsx`)
- Vite Route Dispatcher → Login and Registration: routes to (evidence: `apps/react-vite/src/app/router.tsx`)
- Vite Route Dispatcher → Dashboard: routes to (evidence: `apps/react-vite/src/app/router.tsx`)
- Landing Page → Dashboard: navigates (evidence: `apps/react-vite/src/app/routes/landing.tsx`)
- Landing Page → Login and Registration: navigates (evidence: `apps/react-vite/src/app/routes/landing.tsx`)
- App Router Pages → Discussions: renders (evidence: `apps/nextjs-app/src/app/app/discussions/page.tsx`)
- App Router Pages → Admin Guard: wraps (evidence: `apps/nextjs-app/src/app/app/users/page.tsx`)
- App Router Pages → User Administration: renders (evidence: `apps/nextjs-app/src/app/app/users/page.tsx`)
