# bakerdandal1234/my-app-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/bakerdandal1234/my-app-frontend
- Repository: https://github.com/bakerdandal1234/my-app-frontend

## Overview

This is a React/TypeScript authentication and access-management frontend. The main workflow routes visitors into registration or login, exchanges credentials through the API, restores session and authorization state, then exposes protected account and administration areas. Distinct capabilities include email verification, OAuth and two-factor challenges, session/login-history and profile security, plus role, permission and user-access administration. The source index and excerpts establish the shared API/auth layers; several page implementations are unsampled, so uncertain page-to-service links are omitted.

Main entry points: [`src/App.tsx`](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/App.tsx) (Routes and shell), [`src/auth/authorization/authorization-api.ts`](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/authorization/authorization-api.ts) (Authorization operations), [`src/auth/api.ts`](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/api.ts) (Authentication operations), [`src/api/client.ts`](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/api/client.ts) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app["Routes and shell<br/>[App.tsx]"]
  node_landing["Landing page<br/>[LandingPage.tsx]"]
end

subgraph group_auth["Authentication"]
  node_login["Login<br/>[LoginPage.tsx]"]
  node_register["Registration<br/>[RegisterPage.tsx]"]
  node_verify["Email verification"]
  node_oauth["OAuth callback"]
  node_loginhook["Login flow hook<br/>[useLogin.ts]"]
  node_oauthhook["OAuth callback hook"]
  node_authcontext["Session and access state<br/>[AuthContext.tsx]"]
  node_guards["Route guards"]
  node_authapi["Authentication operations<br/>[api.ts]"]
end

subgraph group_account["Account security"]
  node_accountpages["Profile and security"]
  node_sessions["Sessions page<br/>[SessionsPage.tsx]"]
  node_sessionhook["Session operations hook<br/>[useSessions.ts]"]
  node_history["Login history"]
end

subgraph group_admin["Access administration"]
  node_adminusers["User access administration"]
  node_roles["Role administration<br/>[AdminRolesPage.tsx]"]
  node_permissions["Permission administration"]
  node_accessapi["Authorization operations"]
  node_contracts["Authorization contracts"]
end

subgraph group_shared["Shared services"]
  node_client["HTTP client<br/>[client.ts]"]
  node_token["In-memory token store<br/>[tokenStore.ts]"]
  node_validation["Response validation<br/>[validation.ts]"]
end

node_visitor(("Visitor"))
node_backend{{"Authentication and access API"}}

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"routes to"| node_verify
node_app -->|"routes to"| node_oauth
node_app -->|"routes to"| node_accountpages
node_app -->|"routes to"| node_sessions
node_app -->|"routes to"| node_history
node_app -->|"routes to"| node_adminusers
node_app -->|"routes to"| node_roles
node_app -->|"routes to"| node_permissions
node_app -->|"registers"| node_guards
node_login -->|"uses"| node_loginhook
node_loginhook -->|"calls"| node_authapi
node_oauth -->|"uses"| node_oauthhook
node_oauthhook -->|"calls"| node_authapi
node_register -->|"calls"| node_authapi
node_authcontext -->|"loads session"| node_authapi
node_authcontext -->|"loads access"| node_accessapi
node_sessions -->|"uses"| node_sessionhook
node_roles -->|"manages roles"| node_accessapi
node_permissions -->|"manages permissions"| node_accessapi
node_accessapi -->|"validates as"| node_contracts
node_authapi -->|"sends requests"| node_client
node_accessapi -->|"sends requests"| node_client
node_client -->|"reads and updates"| node_token
node_client -->|"requests"| node_backend
node_accessapi -->|"parses responses"| node_validation
node_authapi -->|"parses responses"| node_validation

click node_app "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/App.tsx"
click node_landing "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/LandingPage.tsx"
click node_login "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/auth/login/LoginPage.tsx"
click node_register "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/auth/register/RegisterPage.tsx"
click node_verify "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/auth/email-verification/VerifyEmailPage.tsx"
click node_oauth "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/auth/oauth/OAuthCallbackPage.tsx"
click node_loginhook "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/hooks/useLogin.ts"
click node_oauthhook "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/hooks/useOAuthCallback.ts"
click node_authcontext "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/AuthContext.tsx"
click node_guards "https://github.com/bakerdandal1234/my-app-frontend/tree/main/src/auth/guards"
click node_authapi "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/api.ts"
click node_accountpages "https://github.com/bakerdandal1234/my-app-frontend/tree/main/src/pages/user"
click node_sessions "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/user/SessionsPage.tsx"
click node_sessionhook "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/hooks/useSessions.ts"
click node_history "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/user/LoginHistoryPage.tsx"
click node_adminusers "https://github.com/bakerdandal1234/my-app-frontend/tree/main/src/pages/admin/users"
click node_roles "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/admin/roles/AdminRolesPage.tsx"
click node_permissions "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/admin/permissions/AdminPermissionsPage.tsx"
click node_accessapi "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/authorization/authorization-api.ts"
click node_contracts "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/authorization/authorization-contracts.ts"
click node_client "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/api/client.ts"
click node_token "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/api/tokenStore.ts"
click node_validation "https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/api/validation.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_landing toneBlue
class node_login,node_register,node_verify,node_oauth,node_loginhook,node_oauthhook,node_authcontext,node_guards,node_authapi toneAmber
class node_accountpages,node_sessions,node_sessionhook,node_history,node_backend toneMint
class node_adminusers,node_roles,node_permissions,node_accessapi,node_contracts toneRose
class node_client,node_token,node_validation,node_visitor toneIndigo
```

## Components

### Application

- [Routes and shell](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/App.tsx): `src/App.tsx`
- [Landing page](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/LandingPage.tsx): `src/pages/LandingPage.tsx`

### Authentication

- [Login](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/auth/login/LoginPage.tsx): `src/pages/auth/login/LoginPage.tsx`
- [Registration](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/auth/register/RegisterPage.tsx): `src/pages/auth/register/RegisterPage.tsx`
- [Email verification](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/auth/email-verification/VerifyEmailPage.tsx): `src/pages/auth/email-verification/VerifyEmailPage.tsx`
- [OAuth callback](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/auth/oauth/OAuthCallbackPage.tsx): `src/pages/auth/oauth/OAuthCallbackPage.tsx`
- [Login flow hook](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/hooks/useLogin.ts): `src/auth/hooks/useLogin.ts`
- [OAuth callback hook](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/hooks/useOAuthCallback.ts): `src/auth/hooks/useOAuthCallback.ts`
- [Session and access state](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/AuthContext.tsx): `src/auth/AuthContext.tsx`
- [Route guards](https://github.com/bakerdandal1234/my-app-frontend/tree/main/src/auth/guards): `src/auth/guards`
- [Authentication operations](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/api.ts): `src/auth/api.ts`

### Account security

- [Profile and security](https://github.com/bakerdandal1234/my-app-frontend/tree/main/src/pages/user): `src/pages/user`
- [Sessions page](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/user/SessionsPage.tsx): `src/pages/user/SessionsPage.tsx`
- [Session operations hook](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/hooks/useSessions.ts): `src/auth/hooks/useSessions.ts`
- [Login history](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/user/LoginHistoryPage.tsx): `src/pages/user/LoginHistoryPage.tsx`

### Access administration

- [User access administration](https://github.com/bakerdandal1234/my-app-frontend/tree/main/src/pages/admin/users): `src/pages/admin/users`
- [Role administration](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/admin/roles/AdminRolesPage.tsx): `src/pages/admin/roles/AdminRolesPage.tsx`
- [Permission administration](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/pages/admin/permissions/AdminPermissionsPage.tsx): `src/pages/admin/permissions/AdminPermissionsPage.tsx`
- [Authorization operations](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/authorization/authorization-api.ts): `src/auth/authorization/authorization-api.ts`
- [Authorization contracts](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/auth/authorization/authorization-contracts.ts): `src/auth/authorization/authorization-contracts.ts`

### Shared services

- [HTTP client](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/api/client.ts): `src/api/client.ts`
- [In-memory token store](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/api/tokenStore.ts): `src/api/tokenStore.ts`
- [Response validation](https://github.com/bakerdandal1234/my-app-frontend/blob/main/src/api/validation.ts): `src/api/validation.ts`

### Other components

- **Visitor**
- **Authentication and access API**

## Connections

- Visitor → Routes and shell: opens (evidence: `src/App.tsx`)
- Routes and shell → Landing page: routes to (evidence: `src/App.tsx`)
- Routes and shell → Login: routes to (evidence: `src/App.tsx`)
- Routes and shell → Registration: routes to (evidence: `src/App.tsx`)
- Routes and shell → Email verification: routes to (evidence: `src/App.tsx`)
- Routes and shell → OAuth callback: routes to (evidence: `src/App.tsx`)
- Routes and shell → Profile and security: routes to (evidence: `src/App.tsx`)
- Routes and shell → Sessions page: routes to (evidence: `src/App.tsx`)
- Routes and shell → Login history: routes to (evidence: `src/App.tsx`)
- Routes and shell → User access administration: routes to (evidence: `src/App.tsx`)
- Routes and shell → Role administration: routes to (evidence: `src/App.tsx`)
- Routes and shell → Permission administration: routes to (evidence: `src/App.tsx`)
- Routes and shell → Route guards: registers (evidence: `src/App.tsx`)
- Login → Login flow hook: uses (evidence: `src/pages/auth/login/LoginPage.tsx`)
- Login flow hook → Authentication operations: calls (evidence: `src/auth/hooks/useLogin.ts`)
- OAuth callback → OAuth callback hook: uses (evidence: `src/pages/auth/oauth/OAuthCallbackPage.tsx`)
- OAuth callback hook → Authentication operations: calls (evidence: `src/auth/hooks/useOAuthCallback.ts`)
- Registration → Authentication operations: calls (evidence: `src/pages/auth/register/RegisterPage.tsx`)
- Session and access state → Authentication operations: loads session (evidence: `src/auth/AuthContext.tsx`)
- Session and access state → Authorization operations: loads access (evidence: `src/auth/AuthContext.tsx`)
- Sessions page → Session operations hook: uses (evidence: `src/pages/user/SessionsPage.tsx`)
- Role administration → Authorization operations: manages roles (evidence: `src/pages/admin/roles/AdminRolesPage.tsx`)
- Permission administration → Authorization operations: manages permissions (evidence: `src/pages/admin/permissions/AdminPermissionsPage.tsx`)
- Authorization operations → Authorization contracts: validates as (evidence: `src/auth/authorization/authorization-api.ts`)
- Authentication operations → HTTP client: sends requests (evidence: `src/auth/api.ts`)
- Authorization operations → HTTP client: sends requests (evidence: `src/auth/authorization/authorization-api.ts`)
- HTTP client → In-memory token store: reads and updates (evidence: `src/api/client.ts`)
- HTTP client → Authentication and access API: requests (evidence: `src/api/client.ts`)
- Authorization operations → Response validation: parses responses (evidence: `src/auth/authorization/authorization-api.ts`)
- Authentication operations → Response validation: parses responses (evidence: `src/auth/api.ts`)
