# socoda332/lumina_horizon architecture

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

- Interactive diagram: https://gitdiagram.com/socoda332/lumina_horizon
- Repository: https://github.com/socoda332/lumina_horizon

## Overview

Lumina Horizon is represented in the available files as a Next.js application shell plus a reusable React UI component library; the README provides no product-specific workflow or feature description. The visible runtime path is a user reaching the root layout, which renders page content and Vercel Analytics. Most UI modules are standalone primitives rather than a demonstrated end-to-end domain workflow. The graph preserves major component families and the sampled sidebar and toast dependencies; unsampled components are grouped by responsibility, so their internal wiring is not inferred.

Main entry points: [`components/ui/sidebar.tsx`](https://github.com/socoda332/lumina_horizon/blob/main/components/ui/sidebar.tsx) (Sidebar navigation), [`app/layout.tsx`](https://github.com/socoda332/lumina_horizon/blob/main/app/layout.tsx) (Root layout), [`hooks/use-toast.ts`](https://github.com/socoda332/lumina_horizon/blob/main/hooks/use-toast.ts) (Toast state hook), [`components/ui`](https://github.com/socoda332/lumina_horizon/tree/main/components/ui) (Buttons and inputs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_layout["Root layout<br/>[layout.tsx]"]
  node_analytics["Vercel Analytics"]
  node_theme["Theme provider<br/>[theme-provider.tsx]"]
end

subgraph group_primitives["UI primitives"]
  node_base_ui["Buttons and inputs"]
  node_form_ui["Forms and fields"]
  node_display_ui["Display components"]
end

subgraph group_interactions["Menus and navigation"]
  node_menu_ui["Menus and dialogs"]
  node_sidebar["Sidebar navigation<br/>[sidebar.tsx]"]
end

subgraph group_data_feedback["Charts and feedback"]
  node_chart["Charts<br/>[chart.tsx]"]
  node_toast_ui["Toast presentation<br/>[toast.tsx]"]
  node_toast_state["Toast state hook<br/>[use-toast.ts]"]
end

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

node_user(("User"))

node_user -.->|"opens app"| node_layout
node_layout -->|"renders"| node_analytics
node_sidebar -->|"checks breakpoint"| node_mobile_hook
node_sidebar -->|"uses button"| node_base_ui
node_sidebar -->|"uses sheet"| node_menu_ui
node_sidebar -->|"uses tooltip"| node_display_ui
node_toast_state -->|"uses toast types"| node_toast_ui

click node_layout "https://github.com/socoda332/lumina_horizon/blob/main/app/layout.tsx"
click node_theme "https://github.com/socoda332/lumina_horizon/blob/main/components/theme-provider.tsx"
click node_base_ui "https://github.com/socoda332/lumina_horizon/tree/main/components/ui"
click node_form_ui "https://github.com/socoda332/lumina_horizon/tree/main/components/ui"
click node_display_ui "https://github.com/socoda332/lumina_horizon/tree/main/components/ui"
click node_menu_ui "https://github.com/socoda332/lumina_horizon/tree/main/components/ui"
click node_sidebar "https://github.com/socoda332/lumina_horizon/blob/main/components/ui/sidebar.tsx"
click node_chart "https://github.com/socoda332/lumina_horizon/blob/main/components/ui/chart.tsx"
click node_toast_ui "https://github.com/socoda332/lumina_horizon/blob/main/components/ui/toast.tsx"
click node_toast_state "https://github.com/socoda332/lumina_horizon/blob/main/hooks/use-toast.ts"
click node_mobile_hook "https://github.com/socoda332/lumina_horizon/blob/main/hooks/use-mobile.ts"
click node_class_utils "https://github.com/socoda332/lumina_horizon/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_layout,node_analytics,node_theme,node_user toneBlue
class node_base_ui,node_form_ui,node_display_ui toneAmber
class node_menu_ui,node_sidebar toneMint
class node_chart,node_toast_ui,node_toast_state toneRose
class node_mobile_hook,node_class_utils toneIndigo
```

## Components

### Application shell

- [Root layout](https://github.com/socoda332/lumina_horizon/blob/main/app/layout.tsx): `app/layout.tsx`
- **Vercel Analytics**
- [Theme provider](https://github.com/socoda332/lumina_horizon/blob/main/components/theme-provider.tsx): `components/theme-provider.tsx`

### UI primitives

- [Buttons and inputs](https://github.com/socoda332/lumina_horizon/tree/main/components/ui): `components/ui`
- [Forms and fields](https://github.com/socoda332/lumina_horizon/tree/main/components/ui): `components/ui`
- [Display components](https://github.com/socoda332/lumina_horizon/tree/main/components/ui): `components/ui`

### Menus and navigation

- [Menus and dialogs](https://github.com/socoda332/lumina_horizon/tree/main/components/ui): `components/ui`
- [Sidebar navigation](https://github.com/socoda332/lumina_horizon/blob/main/components/ui/sidebar.tsx): `components/ui/sidebar.tsx`

### Charts and feedback

- [Charts](https://github.com/socoda332/lumina_horizon/blob/main/components/ui/chart.tsx): `components/ui/chart.tsx`
- [Toast presentation](https://github.com/socoda332/lumina_horizon/blob/main/components/ui/toast.tsx): `components/ui/toast.tsx`
- [Toast state hook](https://github.com/socoda332/lumina_horizon/blob/main/hooks/use-toast.ts): `hooks/use-toast.ts`

### Shared behavior

- [Mobile breakpoint hook](https://github.com/socoda332/lumina_horizon/blob/main/hooks/use-mobile.ts): `hooks/use-mobile.ts`
- [Class utilities](https://github.com/socoda332/lumina_horizon/blob/main/lib/utils.ts): `lib/utils.ts`

### Other components

- **User**

## Connections

- User → Root layout: opens app
- Root layout → Vercel Analytics: renders (evidence: `app/layout.tsx`)
- Sidebar navigation → Mobile breakpoint hook: checks breakpoint (evidence: `components/ui/sidebar.tsx`)
- Sidebar navigation → Buttons and inputs: uses button (evidence: `components/ui/sidebar.tsx`)
- Sidebar navigation → Menus and dialogs: uses sheet (evidence: `components/ui/sidebar.tsx`)
- Sidebar navigation → Display components: uses tooltip (evidence: `components/ui/sidebar.tsx`)
- Toast state hook → Toast presentation: uses toast types (evidence: `hooks/use-toast.ts`)
