# mich8060/unified-design-system architecture

> Architecture diagram of the GitHub repository mich8060/unified-design-system, 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/mich8060/unified-design-system
- Repository: https://github.com/mich8060/unified-design-system

## Overview

UDS is a React component and styling package for consumer applications. The main consumer flow is to install the package, import its public API and stylesheet, compose AppShell and Menu around application content, and use domain components such as inputs, date controls, and file-upload controls within that experience. The graph also shows shared branding and class utilities. README statements and sampled imports support the relationships shown; unsampled component internals are represented at subsystem level rather than assumed.

Main entry points: [`src/components/ui/menu.tsx`](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/menu.tsx) (Menu navigation), [`src/lib/utils.ts`](https://github.com/mich8060/unified-design-system/blob/main/src/lib/utils.ts) (Class utilities), [`src/components/ui/app-shell.tsx`](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/app-shell.tsx) (AppShell), [`src/components/ui/input.tsx`](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/input.tsx) (Input)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_app_shell["AppShell<br/>[app-shell.tsx]"]
  node_shell_chrome["Shell chrome"]
  node_menu["Menu navigation<br/>[menu.tsx]"]
  node_header["Header<br/>[header.tsx]"]
end

subgraph group_controls["Interactive controls"]
  node_button["Button<br/>[button.tsx]"]
  node_context_menu["Context menu<br/>[context-menu.tsx]"]
  node_dropdown_menu["Dropdown menu<br/>[dropdown-menu.tsx]"]
  node_select["Select<br/>[select.tsx]"]
  node_input["Input<br/>[input.tsx]"]
  node_input_group["Input group<br/>[input-group.tsx]"]
  node_search["Search input<br/>[search-input.tsx]"]
end

subgraph group_domain["Domain components"]
  node_date_range["Date range"]
  node_file_upload["File upload cards"]
  node_field["Field<br/>[field.tsx]"]
  node_status["Status indicator<br/>[dot-status.tsx]"]
end

subgraph group_foundation["Shared foundations"]
  node_public_api["Public exports<br/>[index.ts]"]
  node_branding["Branding<br/>[branding.tsx]"]
  node_brand_config["Brand configuration<br/>[uds-brand.ts]"]
  node_class_utils["Class utilities<br/>[utils.ts]"]
  node_styles["Styles and tokens<br/>[styles.ts]"]
end

node_consumer(("Consumer app"))

node_consumer -->|"imports components"| node_public_api
node_public_api -->|"exports"| node_app_shell
node_public_api -->|"exports"| node_menu
node_consumer -->|"imports stylesheet"| node_styles
node_consumer -->|"composes shell"| node_app_shell
node_consumer -->|"composes navigation"| node_menu
node_app_shell -->|"uses chrome"| node_shell_chrome
node_app_shell -->|"uses header"| node_header
node_menu -->|"uses buttons"| node_button
node_menu -->|"uses menus"| node_dropdown_menu
node_menu -->|"uses select"| node_select
node_menu -->|"resolves brand"| node_brand_config
node_brand_config -->|"maps appearance"| node_branding
node_search -->|"composes field"| node_input_group
node_search -->|"uses input"| node_input
node_search -->|"merges classes"| node_class_utils
node_input_group -->|"uses input"| node_input
node_select -->|"uses variants"| node_input
node_button -.->|"styles classes"| node_class_utils
node_context_menu -->|"merges classes"| node_class_utils
node_dropdown_menu -->|"merges classes"| node_class_utils
node_input -->|"merges classes"| node_class_utils
node_consumer -->|"uses date control"| node_date_range
node_consumer -.->|"uses upload control"| node_file_upload
node_consumer -.->|"uses form fields"| node_field
node_consumer -.->|"uses status display"| node_status

click node_public_api "https://github.com/mich8060/unified-design-system/blob/main/src/index.ts"
click node_app_shell "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/app-shell.tsx"
click node_shell_chrome "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/app-shell-chrome.tsx"
click node_menu "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/menu.tsx"
click node_header "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/header.tsx"
click node_branding "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/branding.tsx"
click node_brand_config "https://github.com/mich8060/unified-design-system/blob/main/src/lib/uds-brand.ts"
click node_button "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/button.tsx"
click node_context_menu "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/context-menu.tsx"
click node_dropdown_menu "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/dropdown-menu.tsx"
click node_select "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/select.tsx"
click node_input "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/input.tsx"
click node_input_group "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/input-group.tsx"
click node_search "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/search-input.tsx"
click node_date_range "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/date-range-input.tsx"
click node_file_upload "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/file-upload-cards.tsx"
click node_field "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/field.tsx"
click node_status "https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/dot-status.tsx"
click node_class_utils "https://github.com/mich8060/unified-design-system/blob/main/src/lib/utils.ts"
click node_styles "https://github.com/mich8060/unified-design-system/blob/main/src/styles.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_shell,node_shell_chrome,node_menu,node_header toneBlue
class node_button,node_context_menu,node_dropdown_menu,node_select,node_input,node_input_group,node_search toneAmber
class node_date_range,node_file_upload,node_field,node_status toneMint
class node_public_api,node_branding,node_brand_config,node_class_utils,node_styles toneRose
class node_consumer toneIndigo
```

## Components

### Application shell

- [AppShell](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/app-shell.tsx): `src/components/ui/app-shell.tsx`
- [Shell chrome](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/app-shell-chrome.tsx): `src/components/ui/app-shell-chrome.tsx`
- [Menu navigation](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/menu.tsx): `src/components/ui/menu.tsx`
- [Header](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/header.tsx): `src/components/ui/header.tsx`

### Interactive controls

- [Button](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`
- [Context menu](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/context-menu.tsx): `src/components/ui/context-menu.tsx`
- [Dropdown menu](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/dropdown-menu.tsx): `src/components/ui/dropdown-menu.tsx`
- [Select](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/select.tsx): `src/components/ui/select.tsx`
- [Input](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/input.tsx): `src/components/ui/input.tsx`
- [Input group](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/input-group.tsx): `src/components/ui/input-group.tsx`
- [Search input](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/search-input.tsx): `src/components/ui/search-input.tsx`

### Domain components

- [Date range](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/date-range-input.tsx): `src/components/ui/date-range-input.tsx`
- [File upload cards](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/file-upload-cards.tsx): `src/components/ui/file-upload-cards.tsx`
- [Field](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/field.tsx): `src/components/ui/field.tsx`
- [Status indicator](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/dot-status.tsx): `src/components/ui/dot-status.tsx`

### Shared foundations

- [Public exports](https://github.com/mich8060/unified-design-system/blob/main/src/index.ts): `src/index.ts`
- [Branding](https://github.com/mich8060/unified-design-system/blob/main/src/components/ui/branding.tsx): `src/components/ui/branding.tsx`
- [Brand configuration](https://github.com/mich8060/unified-design-system/blob/main/src/lib/uds-brand.ts): `src/lib/uds-brand.ts`
- [Class utilities](https://github.com/mich8060/unified-design-system/blob/main/src/lib/utils.ts): `src/lib/utils.ts`
- [Styles and tokens](https://github.com/mich8060/unified-design-system/blob/main/src/styles.ts): `src/styles.ts`

### Other components

- **Consumer app**

## Connections

- Consumer app → Public exports: imports components (evidence: `README.md`)
- Public exports → AppShell: exports (evidence: `src/index.ts`)
- Public exports → Menu navigation: exports (evidence: `src/index.ts`)
- Consumer app → Styles and tokens: imports stylesheet (evidence: `README.md`)
- Consumer app → AppShell: composes shell (evidence: `README.md`)
- Consumer app → Menu navigation: composes navigation (evidence: `README.md`)
- AppShell → Shell chrome: uses chrome (evidence: `src/components/ui/app-shell.tsx`)
- AppShell → Header: uses header (evidence: `src/components/ui/app-shell.tsx`)
- Menu navigation → Button: uses buttons (evidence: `src/components/ui/menu.tsx`)
- Menu navigation → Dropdown menu: uses menus (evidence: `src/components/ui/menu.tsx`)
- Menu navigation → Select: uses select (evidence: `src/components/ui/menu.tsx`)
- Menu navigation → Brand configuration: resolves brand (evidence: `src/components/ui/menu.tsx`)
- Brand configuration → Branding: maps appearance (evidence: `src/lib/uds-brand.ts`)
- Search input → Input group: composes field (evidence: `src/components/ui/search-input.tsx`)
- Search input → Input: uses input (evidence: `src/components/ui/search-input.tsx`)
- Search input → Class utilities: merges classes (evidence: `src/components/ui/search-input.tsx`)
- Input group → Input: uses input (evidence: `src/components/ui/input-group.tsx`)
- Select → Input: uses variants (evidence: `src/components/ui/select.tsx`)
- Button → Class utilities: styles classes
- Context menu → Class utilities: merges classes (evidence: `src/components/ui/context-menu.tsx`)
- Dropdown menu → Class utilities: merges classes (evidence: `src/components/ui/dropdown-menu.tsx`)
- Input → Class utilities: merges classes (evidence: `src/components/ui/input.tsx`)
- Consumer app → Date range: uses date control (evidence: `README.md`)
- Consumer app → File upload cards: uses upload control
- Consumer app → Field: uses form fields
- Consumer app → Status indicator: uses status display
