# bilalismail59/fullstack-infrastructure architecture

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

- Interactive diagram: https://gitdiagram.com/bilalismail59/fullstack-infrastructure
- Repository: https://github.com/bilalismail59/fullstack-infrastructure

## Overview

The README describes a GCP stack with a React frontend, WordPress backend, MySQL, and monitoring, but the supplied tree contains no backend, infrastructure, or monitoring implementation files. The visible code is primarily a frontend shell and reusable UI components; the principal user workflow cannot be traced beyond the application entry page. The graph therefore distinguishes documented stack components from the implementation visible here. UI relationships are limited to imports shown in the source index or excerpts.

Main entry points: [`components/ui/sidebar.tsx`](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/sidebar.tsx) (Sidebar), [`app/page.tsx`](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/app/page.tsx) (App entry page), [`hooks/use-toast.ts`](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/hooks/use-toast.ts) (Toast state hook), [`app/layout.tsx`](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/app/layout.tsx) (Root layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend shell"]
  node_app["App entry page<br/>[page.tsx]"]
  node_layout["Root layout<br/>[layout.tsx]"]
  node_theme["Theme provider<br/>[theme-provider.tsx]"]
end

subgraph group_ui["UI components"]
  node_ui_primitives["UI primitives"]
  node_ui_navigation["Menus and navigation"]
  node_ui_overlays["Dialogs and sheets"]
  node_ui_data["Charts and tables"]
  node_sidebar["Sidebar<br/>[sidebar.tsx]"]
  node_sheet["Sheet<br/>[sheet.tsx]"]
  node_tooltip["Tooltip<br/>[tooltip.tsx]"]
  node_button["Button<br/>[button.tsx]"]
  node_input["Input<br/>[input.tsx]"]
  node_separator["Separator<br/>[separator.tsx]"]
  node_skeleton["Skeleton<br/>[skeleton.tsx]"]
  node_toast_view["Toast components<br/>[toast.tsx]"]
end

subgraph group_shared["Shared behavior"]
  node_toast_hook["Toast state hook<br/>[use-toast.ts]"]
  node_mobile_hook["Mobile breakpoint hook<br/>[use-mobile.tsx]"]
  node_class_utils["Class utilities<br/>[utils.ts]"]
end

node_user(("Application user"))
node_wordpress["WordPress backend"]
node_mysql[("MySQL database")]
node_monitoring["Prometheus and Grafana"]

node_user -.->|"opens"| node_app
node_app -.->|"renders within"| node_layout
node_sidebar -->|"checks viewport"| node_mobile_hook
node_sidebar -->|"renders mobile panel"| node_sheet
node_sidebar -->|"renders tooltips"| node_tooltip
node_sidebar -->|"renders trigger"| node_button
node_sidebar -->|"imports"| node_input
node_sidebar -->|"imports"| node_separator
node_sidebar -->|"imports"| node_skeleton
node_toast_hook -->|"uses toast types"| node_toast_view
node_wordpress -.->|"uses database"| node_mysql
node_monitoring -.->|"monitors stack"| node_wordpress

click node_app "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/app/page.tsx"
click node_layout "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/app/layout.tsx"
click node_theme "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/theme-provider.tsx"
click node_ui_primitives "https://github.com/bilalismail59/fullstack-infrastructure/tree/main/components/ui"
click node_ui_navigation "https://github.com/bilalismail59/fullstack-infrastructure/tree/main/components/ui"
click node_ui_overlays "https://github.com/bilalismail59/fullstack-infrastructure/tree/main/components/ui"
click node_ui_data "https://github.com/bilalismail59/fullstack-infrastructure/tree/main/components/ui"
click node_sidebar "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/sidebar.tsx"
click node_sheet "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/sheet.tsx"
click node_tooltip "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/tooltip.tsx"
click node_button "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/button.tsx"
click node_input "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/input.tsx"
click node_separator "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/separator.tsx"
click node_skeleton "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/skeleton.tsx"
click node_toast_hook "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/hooks/use-toast.ts"
click node_toast_view "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/toast.tsx"
click node_mobile_hook "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/hooks/use-mobile.tsx"
click node_class_utils "https://github.com/bilalismail59/fullstack-infrastructure/blob/main/lib/utils.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_layout,node_theme,node_user toneBlue
class node_ui_primitives,node_ui_navigation,node_ui_overlays,node_ui_data,node_sidebar,node_sheet,node_tooltip,node_button,node_input,node_separator,node_skeleton,node_toast_view,node_mysql toneAmber
class node_toast_hook,node_mobile_hook,node_class_utils toneMint
class node_wordpress,node_monitoring toneIndigo
```

## Components

### Frontend shell

- [App entry page](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/app/page.tsx): `app/page.tsx`
- [Root layout](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/app/layout.tsx): `app/layout.tsx`
- [Theme provider](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/theme-provider.tsx): `components/theme-provider.tsx`

### UI components

- [UI primitives](https://github.com/bilalismail59/fullstack-infrastructure/tree/main/components/ui): `components/ui`
- [Menus and navigation](https://github.com/bilalismail59/fullstack-infrastructure/tree/main/components/ui): `components/ui`
- [Dialogs and sheets](https://github.com/bilalismail59/fullstack-infrastructure/tree/main/components/ui): `components/ui`
- [Charts and tables](https://github.com/bilalismail59/fullstack-infrastructure/tree/main/components/ui): `components/ui`
- [Sidebar](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/sidebar.tsx): `components/ui/sidebar.tsx`
- [Sheet](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/sheet.tsx): `components/ui/sheet.tsx`
- [Tooltip](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/tooltip.tsx): `components/ui/tooltip.tsx`
- [Button](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/button.tsx): `components/ui/button.tsx`
- [Input](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/input.tsx): `components/ui/input.tsx`
- [Separator](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/separator.tsx): `components/ui/separator.tsx`
- [Skeleton](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/skeleton.tsx): `components/ui/skeleton.tsx`
- [Toast components](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/components/ui/toast.tsx): `components/ui/toast.tsx`

### Shared behavior

- [Toast state hook](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/hooks/use-toast.ts): `hooks/use-toast.ts`
- [Mobile breakpoint hook](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/hooks/use-mobile.tsx): `hooks/use-mobile.tsx`
- [Class utilities](https://github.com/bilalismail59/fullstack-infrastructure/blob/main/lib/utils.ts): `lib/utils.ts`

### Other components

- **Application user**
- **WordPress backend**
- **MySQL database**
- **Prometheus and Grafana**

## Connections

- Application user → App entry page: opens (evidence: `README.md`)
- App entry page → Root layout: renders within
- Sidebar → Mobile breakpoint hook: checks viewport (evidence: `components/ui/sidebar.tsx`)
- Sidebar → Sheet: renders mobile panel (evidence: `components/ui/sidebar.tsx`)
- Sidebar → Tooltip: renders tooltips (evidence: `components/ui/sidebar.tsx`)
- Sidebar → Button: renders trigger (evidence: `components/ui/sidebar.tsx`)
- Sidebar → Input: imports (evidence: `components/ui/sidebar.tsx`)
- Sidebar → Separator: imports (evidence: `components/ui/sidebar.tsx`)
- Sidebar → Skeleton: imports (evidence: `components/ui/sidebar.tsx`)
- Toast state hook → Toast components: uses toast types (evidence: `hooks/use-toast.ts`)
- WordPress backend → MySQL database: uses database (evidence: `README.md`)
- Prometheus and Grafana → WordPress backend: monitors stack (evidence: `README.md`)
