# itsvivekramachandran/ailabs-designsystem architecture

> Architecture diagram of the GitHub repository itsvivekramachandran/ailabs-designsystem, 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/itsvivekramachandran/ailabs-designsystem
- Repository: https://github.com/itsvivekramachandran/ailabs-designsystem

## Overview

This is an Angular design-system package with a live component playground. The main user flow is consuming an exported component or token, which renders a styled, accessible UI control; the playground also lets users explore components, themes, and token values. The map includes the documented control families and token/style layers. Only sampled caller relationships are connected; unsampled components are included based on the README and source index, without asserting implementation details.

Main entry points: [`src/app/design-system/icon.component.ts`](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/icon.component.ts) (Icon component), [`src/app/design-system/date-picker.component.ts`](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/date-picker.component.ts) (Date picker), [`src/app/design-system/time-picker.component.ts`](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/time-picker.component.ts) (Time picker), [`src/app/app.component.ts`](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/app.component.ts) (Interactive showcase)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_playground["Showcase"]
  node_bootstrap["Angular bootstrap<br/>[main.ts]"]
  node_showcase["Interactive showcase<br/>[app.component.ts]"]
end

subgraph group_components["UI components"]
  node_controls["Control components"]
  node_alert["Alert<br/>[alert.component.ts]"]
  node_dropdown["Dropdown"]
  node_toolbar["Toolbar"]
  node_tabs["Tabs<br/>[tab.component.ts]"]
  node_icons["Icon component<br/>[icon.component.ts]"]
  node_icondata["Material icon registry<br/>[material-icons.ts]"]
end

subgraph group_pickers["Pickers and overlays"]
  node_date["Date picker"]
  node_time["Time picker"]
  node_overlay["Overlay positioning<br/>[overlay.ts]"]
  node_pickerutils["Picker utilities<br/>[picker-utils.ts]"]
end

subgraph group_foundation["Design foundations"]
  node_tokens["Typed tokens<br/>[tokens.ts]"]
  node_cssvars["CSS token styles<br/>[tokens.css]"]
  node_componentstyles["Component styles<br/>[components.css]"]
  node_globalstyles["Design-system styles<br/>[styles.css]"]
end

subgraph group_package["Public API"]
  node_api["Package exports<br/>[public-api.ts]"]
  node_libraryindex["Component exports<br/>[index.ts]"]
end

node_visitor(("Playground visitor"))
node_consumer(("Angular consumer"))

node_visitor -->|"opens demo"| node_bootstrap
node_bootstrap -->|"bootstraps"| node_showcase
node_showcase -->|"reads tokens"| node_tokens
node_showcase -->|"imports controls"| node_libraryindex
node_alert -->|"renders"| node_icons
node_alert -->|"uses button"| node_controls
node_dropdown -->|"renders"| node_icons
node_dropdown -->|"positions panel"| node_overlay
node_date -->|"renders"| node_icons
node_date -->|"positions panel"| node_overlay
node_date -->|"uses date helpers"| node_pickerutils
node_time -->|"renders"| node_icons
node_time -->|"checks backdrop"| node_overlay
node_time -->|"uses dialog helpers"| node_pickerutils
node_icons -->|"reads registry"| node_icondata
node_api -->|"re-exports"| node_libraryindex
node_consumer -.->|"imports package"| node_api
node_consumer -.->|"loads styles"| node_globalstyles
node_tokens -.->|"paired token layer"| node_cssvars
node_globalstyles -.->|"includes styles"| node_componentstyles

click node_bootstrap "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/main.ts"
click node_showcase "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/app.component.ts"
click node_controls "https://github.com/itsvivekramachandran/ailabs-designsystem/tree/main/src/app/design-system"
click node_alert "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/alert.component.ts"
click node_dropdown "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/dropdown.component.ts"
click node_toolbar "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/toolbar.component.ts"
click node_tabs "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/tab.component.ts"
click node_icons "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/icon.component.ts"
click node_icondata "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/material-icons.ts"
click node_date "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/date-picker.component.ts"
click node_time "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/time-picker.component.ts"
click node_overlay "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/overlay.ts"
click node_pickerutils "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/picker-utils.ts"
click node_tokens "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/design-system/tokens.ts"
click node_cssvars "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/design-system/tokens.css"
click node_componentstyles "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/design-system/components.css"
click node_globalstyles "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/design-system/styles.css"
click node_api "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/public-api.ts"
click node_libraryindex "https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/index.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_bootstrap,node_showcase toneBlue
class node_controls,node_alert,node_dropdown,node_toolbar,node_tabs,node_icons,node_icondata toneAmber
class node_date,node_time,node_overlay,node_pickerutils toneMint
class node_tokens,node_cssvars,node_componentstyles,node_globalstyles toneRose
class node_api,node_libraryindex,node_visitor,node_consumer toneIndigo
```

## Components

### Showcase

- [Angular bootstrap](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/main.ts): `src/main.ts`
- [Interactive showcase](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/app.component.ts): `src/app/app.component.ts`

### UI components

- [Control components](https://github.com/itsvivekramachandran/ailabs-designsystem/tree/main/src/app/design-system): `src/app/design-system`
- [Alert](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/alert.component.ts): `src/app/design-system/alert.component.ts`
- [Dropdown](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/dropdown.component.ts): `src/app/design-system/dropdown.component.ts`
- [Toolbar](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/toolbar.component.ts): `src/app/design-system/toolbar.component.ts`
- [Tabs](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/tab.component.ts): `src/app/design-system/tab.component.ts`
- [Icon component](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/icon.component.ts): `src/app/design-system/icon.component.ts`
- [Material icon registry](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/material-icons.ts): `src/app/design-system/material-icons.ts`

### Pickers and overlays

- [Date picker](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/date-picker.component.ts): `src/app/design-system/date-picker.component.ts`
- [Time picker](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/time-picker.component.ts): `src/app/design-system/time-picker.component.ts`
- [Overlay positioning](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/overlay.ts): `src/app/design-system/overlay.ts`
- [Picker utilities](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/picker-utils.ts): `src/app/design-system/picker-utils.ts`

### Design foundations

- [Typed tokens](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/design-system/tokens.ts): `src/design-system/tokens.ts`
- [CSS token styles](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/design-system/tokens.css): `src/design-system/tokens.css`
- [Component styles](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/design-system/components.css): `src/design-system/components.css`
- [Design-system styles](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/design-system/styles.css): `src/design-system/styles.css`

### Public API

- [Package exports](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/public-api.ts): `src/public-api.ts`
- [Component exports](https://github.com/itsvivekramachandran/ailabs-designsystem/blob/main/src/app/design-system/index.ts): `src/app/design-system/index.ts`

### Other components

- **Playground visitor**
- **Angular consumer**

## Connections

- Playground visitor → Angular bootstrap: opens demo (evidence: `src/main.ts`)
- Angular bootstrap → Interactive showcase: bootstraps (evidence: `src/main.ts`)
- Interactive showcase → Typed tokens: reads tokens (evidence: `src/app/app.component.ts`)
- Interactive showcase → Component exports: imports controls (evidence: `src/app/app.component.ts`)
- Alert → Icon component: renders (evidence: `src/app/design-system/alert.component.ts`)
- Alert → Control components: uses button (evidence: `src/app/design-system/alert.component.ts`)
- Dropdown → Icon component: renders (evidence: `src/app/design-system/dropdown.component.ts`)
- Dropdown → Overlay positioning: positions panel (evidence: `src/app/design-system/dropdown.component.ts`)
- Date picker → Icon component: renders (evidence: `src/app/design-system/date-picker.component.ts`)
- Date picker → Overlay positioning: positions panel (evidence: `src/app/design-system/date-picker.component.ts`)
- Date picker → Picker utilities: uses date helpers (evidence: `src/app/design-system/date-picker.component.ts`)
- Time picker → Icon component: renders (evidence: `src/app/design-system/time-picker.component.ts`)
- Time picker → Overlay positioning: checks backdrop (evidence: `src/app/design-system/time-picker.component.ts`)
- Time picker → Picker utilities: uses dialog helpers (evidence: `src/app/design-system/time-picker.component.ts`)
- Icon component → Material icon registry: reads registry (evidence: `src/app/design-system/icon.component.ts`)
- Package exports → Component exports: re-exports (evidence: `src/public-api.ts`)
- Angular consumer → Package exports: imports package (evidence: `README.md`)
- Angular consumer → Design-system styles: loads styles (evidence: `README.md`)
- Typed tokens → CSS token styles: paired token layer (evidence: `README.md`)
- Design-system styles → Component styles: includes styles (evidence: `README.md`)
