# ameyainspera/inspera-component-library-v2 architecture

> Architecture diagram of the GitHub repository ameyainspera/inspera-component-library-v2, 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/ameyainspera/inspera-component-library-v2
- Repository: https://github.com/ameyainspera/inspera-component-library-v2

## Overview

Inspera is a design-system product: its React components and semantic/token data define the source of truth; the reference site presents those capabilities, while the documented distribution layer generates AI- and tool-facing artifacts. The principal workflow is an engineer or AI tool consulting component guidance and props, then using the library’s accessible, stateful components to build UI. The graph preserves the reference, recipe, and distribution branches. Evidence is limited to the README and the sampled source index/excerpts; unsampled implementation details are not inferred.

Main entry points: [`src/components/inspera/index.ts`](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/index.ts) (Component exports), [`src/docs`](https://github.com/ameyainspera/inspera-component-library-v2/tree/main/src/docs) (Reference pages), [`src/App.tsx`](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/App.tsx) (Reference site app), [`src/components/inspera`](https://github.com/ameyainspera/inspera-component-library-v2/tree/main/src/components/inspera) (Selection controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_reference["Reference experience"]
  node_app["Reference site app<br/>[App.tsx]"]
  node_docs["Reference pages"]
  node_recipes["Component recipes<br/>[recipes.tsx]"]
end

subgraph group_authoritative["Design system sources"]
  node_specs["Component semantics<br/>[components.ts]"]
  node_tokens["Design tokens<br/>[tokens.ts]"]
  node_icons["Icon catalog<br/>[icons.ts]"]
  node_navigation["Navigation data<br/>[navigation.ts]"]
  node_distribution_data["Distribution metadata<br/>[distribution.ts]"]
end

subgraph group_runtime["React component library"]
  node_form_fields["Form field semantics<br/>[FormField.tsx]"]
  node_input_controls["Input controls"]
  node_selection_controls["Selection controls"]
  node_data_display["Tables and grids<br/>[DataGrid.tsx]"]
  node_overlay_tools["Overlay behavior<br/>[overlay.tsx]"]
  node_modal_behavior["Modal accessibility"]
  node_state_hook["Controllable state"]
  node_component_exports["Component exports<br/>[index.ts]"]
end

subgraph group_distribution["Tool distribution"]
  node_ai_artifacts["AI integration artifacts<br/>[build-portable.ts]"]
  node_npm_package["Components package<br/>[index.ts]"]
  node_figma_kit["Figma Make kit<br/>[index.ts]"]
end

node_engineer(("Engineer / AI tool"))

node_engineer -->|"consults"| node_app
node_engineer -->|"uses components"| node_component_exports
node_engineer -->|"uses guidance"| node_ai_artifacts
node_app -->|"routes to"| node_docs
node_app -->|"reads component list"| node_specs
node_app -->|"reads artifact info"| node_distribution_data
node_docs -->|"documents meaning"| node_specs
node_docs -->|"documents tokens"| node_tokens
node_recipes -->|"renders examples"| node_input_controls
node_recipes -->|"renders examples"| node_data_display
node_selection_controls -->|"uses field helpers"| node_form_fields
node_selection_controls -->|"uses overlay helpers"| node_overlay_tools
node_input_controls -->|"uses state hook"| node_state_hook
node_selection_controls -->|"uses state hook"| node_state_hook
node_data_display -->|"renders Select"| node_selection_controls
node_data_display -->|"uses state hook"| node_state_hook
node_modal_behavior -.->|"supports dialogs"| node_overlay_tools
node_component_exports -->|"exports controls"| node_input_controls
node_component_exports -->|"exports data views"| node_data_display
node_specs -->|"generates guidance"| node_ai_artifacts
node_tokens -->|"generates token outputs"| node_ai_artifacts
node_component_exports -->|"provides library"| node_npm_package
node_component_exports -->|"provides components"| node_figma_kit
node_icons -.->|"supports icon reference"| node_docs
node_navigation -.->|"supports navigation"| node_docs

click node_app "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/App.tsx"
click node_docs "https://github.com/ameyainspera/inspera-component-library-v2/tree/main/src/docs"
click node_recipes "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/recipes.tsx"
click node_specs "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/components.ts"
click node_tokens "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/tokens.ts"
click node_icons "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/icons.ts"
click node_navigation "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/navigation.ts"
click node_distribution_data "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/distribution.ts"
click node_form_fields "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/FormField.tsx"
click node_input_controls "https://github.com/ameyainspera/inspera-component-library-v2/tree/main/src/components/inspera"
click node_selection_controls "https://github.com/ameyainspera/inspera-component-library-v2/tree/main/src/components/inspera"
click node_data_display "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/DataGrid.tsx"
click node_overlay_tools "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/overlay.tsx"
click node_modal_behavior "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/useModalBehavior.ts"
click node_state_hook "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/useControllableState.ts"
click node_component_exports "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/index.ts"
click node_ai_artifacts "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/scripts/build-portable.ts"
click node_npm_package "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/packages/components/src/index.ts"
click node_figma_kit "https://github.com/ameyainspera/inspera-component-library-v2/blob/main/kit/src/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_app,node_docs,node_recipes toneBlue
class node_specs,node_tokens,node_icons,node_navigation,node_distribution_data toneAmber
class node_form_fields,node_input_controls,node_selection_controls,node_data_display,node_overlay_tools,node_modal_behavior,node_state_hook,node_component_exports toneMint
class node_ai_artifacts,node_npm_package,node_figma_kit toneRose
class node_engineer toneIndigo
```

## Components

### Reference experience

- [Reference site app](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/App.tsx): `src/App.tsx`
- [Reference pages](https://github.com/ameyainspera/inspera-component-library-v2/tree/main/src/docs): `src/docs`
- [Component recipes](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/recipes.tsx): `src/data/recipes.tsx`

### Design system sources

- [Component semantics](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/components.ts): `src/data/components.ts`
- [Design tokens](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/tokens.ts): `src/data/tokens.ts`
- [Icon catalog](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/icons.ts): `src/data/icons.ts`
- [Navigation data](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/navigation.ts): `src/data/navigation.ts`
- [Distribution metadata](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/data/distribution.ts): `src/data/distribution.ts`

### React component library

- [Form field semantics](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/FormField.tsx): `src/components/inspera/FormField.tsx`
- [Input controls](https://github.com/ameyainspera/inspera-component-library-v2/tree/main/src/components/inspera): `src/components/inspera`
- [Selection controls](https://github.com/ameyainspera/inspera-component-library-v2/tree/main/src/components/inspera): `src/components/inspera`
- [Tables and grids](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/DataGrid.tsx): `src/components/inspera/DataGrid.tsx`
- [Overlay behavior](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/overlay.tsx): `src/components/inspera/overlay.tsx`
- [Modal accessibility](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/useModalBehavior.ts): `src/components/inspera/useModalBehavior.ts`
- [Controllable state](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/useControllableState.ts): `src/components/inspera/useControllableState.ts`
- [Component exports](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/src/components/inspera/index.ts): `src/components/inspera/index.ts`

### Tool distribution

- [AI integration artifacts](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/scripts/build-portable.ts): `scripts/build-portable.ts`
- [Components package](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/packages/components/src/index.ts): `packages/components/src/index.ts`
- [Figma Make kit](https://github.com/ameyainspera/inspera-component-library-v2/blob/main/kit/src/index.ts): `kit/src/index.ts`

### Other components

- **Engineer / AI tool**

## Connections

- Engineer / AI tool → Reference site app: consults (evidence: `README.md`)
- Engineer / AI tool → Component exports: uses components (evidence: `README.md`)
- Engineer / AI tool → AI integration artifacts: uses guidance (evidence: `README.md`)
- Reference site app → Reference pages: routes to (evidence: `src/App.tsx`)
- Reference site app → Component semantics: reads component list (evidence: `src/App.tsx`)
- Reference site app → Distribution metadata: reads artifact info (evidence: `src/App.tsx`)
- Reference pages → Component semantics: documents meaning (evidence: `README.md`)
- Reference pages → Design tokens: documents tokens (evidence: `README.md`)
- Component recipes → Input controls: renders examples (evidence: `src/data/recipes.tsx`)
- Component recipes → Tables and grids: renders examples (evidence: `src/data/recipes.tsx`)
- Selection controls → Form field semantics: uses field helpers (evidence: `src/components/inspera/Select.tsx`)
- Selection controls → Overlay behavior: uses overlay helpers (evidence: `src/components/inspera/Select.tsx`)
- Input controls → Controllable state: uses state hook (evidence: `src/components/inspera/Checkbox.tsx`)
- Selection controls → Controllable state: uses state hook (evidence: `src/components/inspera/Select.tsx`)
- Tables and grids → Selection controls: renders Select (evidence: `src/components/inspera/DataGrid.tsx`)
- Tables and grids → Controllable state: uses state hook (evidence: `src/components/inspera/DataGrid.tsx`)
- Modal accessibility → Overlay behavior: supports dialogs
- Component exports → Input controls: exports controls (evidence: `src/components/inspera/index.ts`)
- Component exports → Tables and grids: exports data views (evidence: `src/components/inspera/index.ts`)
- Component semantics → AI integration artifacts: generates guidance (evidence: `README.md`)
- Design tokens → AI integration artifacts: generates token outputs (evidence: `README.md`)
- Component exports → Components package: provides library (evidence: `README.md`)
- Component exports → Figma Make kit: provides components (evidence: `kit/src/index.ts`)
- Icon catalog → Reference pages: supports icon reference
- Navigation data → Reference pages: supports navigation
