# doosemavis/bit-design-system architecture

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

- Interactive diagram: https://gitdiagram.com/doosemavis/bit-design-system
- Repository: https://github.com/doosemavis/bit-design-system

## Overview

bit is a React design system with a companion component gallery. The user-facing gallery workflow is route to a component manifest, adjust controls and presets, inspect a live preview, and copy generated JSX; control state is URL-backed. The library supplies themed components, color-mode behavior, and shared class/axis utilities. Gallery routing and page composition are excerpted; library component exports and utility usage are supported by the SOURCE INDEX. Theme CSS and several gallery internals are unsampled, so their implementation links are omitted.

Main entry points: [`apps/gallery/src/pages/ComponentPage.tsx`](https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/pages/ComponentPage.tsx) (Component page), [`packages/react/src/index.ts`](https://github.com/doosemavis/bit-design-system/blob/main/packages/react/src/index.ts) (React package API), [`apps/gallery/src/router.tsx`](https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/router.tsx) (Page routing), [`packages/react/src/system`](https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/system) (Class and axis system)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gallery["Component gallery"]
  node_gallery_app["Gallery app<br/>[main.tsx]"]
  node_routes["Page routing<br/>[router.tsx]"]
  node_page_shell["Gallery shell"]
  node_home_tokens["Home and tokens"]
  node_component_page["Component page<br/>[ComponentPage.tsx]"]
  node_manifests["Component manifests"]
  node_control_state["URL control state<br/>[useControlState.ts]"]
  node_preview_controls["Preview and controls"]
  node_jsx_output["JSX generator<br/>[toJsx.ts]"]
end

subgraph group_library["React components"]
  node_react_api["React package API<br/>[index.ts]"]
  node_actions_layout["Actions and layout"]
  node_forms["Form controls"]
  node_content_choice["Content and choice"]
  node_branding["Brand components"]
end

subgraph group_system["Shared system"]
  node_color_mode["Color mode<br/>[colorMode.ts]"]
  node_class_system["Class and axis system"]
  node_field_context["Field context<br/>[FieldContext.ts]"]
end

subgraph group_core["Tokens and themes"]
  node_token_source["Design tokens<br/>[tokens.ts]"]
  node_theme_css["Theme styles"]
end

node_visitor(("Developer"))

node_visitor -->|"opens"| node_gallery_app
node_gallery_app -->|"renders"| node_routes
node_routes -->|"wraps pages"| node_page_shell
node_routes -->|"routes to"| node_home_tokens
node_routes -->|"routes to"| node_component_page
node_component_page -->|"looks up"| node_manifests
node_component_page -->|"reads state"| node_control_state
node_control_state -->|"parses state"| node_manifests
node_component_page -->|"renders"| node_preview_controls
node_component_page -->|"generates example"| node_jsx_output
node_jsx_output -->|"reads definitions"| node_manifests
node_component_page -->|"uses components"| node_react_api
node_react_api -->|"exports"| node_actions_layout
node_react_api -->|"exports"| node_forms
node_react_api -->|"exports"| node_content_choice
node_react_api -->|"exports"| node_branding
node_actions_layout -->|"builds classes"| node_class_system
node_forms -->|"builds classes"| node_class_system
node_content_choice -->|"builds classes"| node_class_system
node_forms -->|"shares field state"| node_field_context
node_color_mode -->|"sets mode attribute"| node_theme_css
node_class_system -->|"uses axes"| node_token_source
node_gallery_app -->|"loads styles"| node_theme_css

click node_gallery_app "https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/main.tsx"
click node_routes "https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/router.tsx"
click node_page_shell "https://github.com/doosemavis/bit-design-system/tree/main/apps/gallery/src/shell"
click node_home_tokens "https://github.com/doosemavis/bit-design-system/tree/main/apps/gallery/src/pages"
click node_component_page "https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/pages/ComponentPage.tsx"
click node_manifests "https://github.com/doosemavis/bit-design-system/tree/main/apps/gallery/src/manifests"
click node_control_state "https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/engine/useControlState.ts"
click node_preview_controls "https://github.com/doosemavis/bit-design-system/tree/main/apps/gallery/src/engine"
click node_jsx_output "https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/code/toJsx.ts"
click node_react_api "https://github.com/doosemavis/bit-design-system/blob/main/packages/react/src/index.ts"
click node_actions_layout "https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/components"
click node_forms "https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/components"
click node_content_choice "https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/components"
click node_branding "https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/logo"
click node_color_mode "https://github.com/doosemavis/bit-design-system/blob/main/packages/react/src/mode/colorMode.ts"
click node_class_system "https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/system"
click node_field_context "https://github.com/doosemavis/bit-design-system/blob/main/packages/react/src/components/Field/FieldContext.ts"
click node_token_source "https://github.com/doosemavis/bit-design-system/blob/main/packages/core/src/tokens.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_gallery_app,node_routes,node_page_shell,node_home_tokens,node_component_page,node_manifests,node_control_state,node_preview_controls,node_jsx_output toneBlue
class node_react_api,node_actions_layout,node_forms,node_content_choice,node_branding toneAmber
class node_color_mode,node_class_system,node_field_context toneMint
class node_token_source,node_theme_css toneRose
class node_visitor toneIndigo
```

## Components

### Component gallery

- [Gallery app](https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/main.tsx): `apps/gallery/src/main.tsx`
- [Page routing](https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/router.tsx): `apps/gallery/src/router.tsx`
- [Gallery shell](https://github.com/doosemavis/bit-design-system/tree/main/apps/gallery/src/shell): `apps/gallery/src/shell`
- [Home and tokens](https://github.com/doosemavis/bit-design-system/tree/main/apps/gallery/src/pages): `apps/gallery/src/pages`
- [Component page](https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/pages/ComponentPage.tsx): `apps/gallery/src/pages/ComponentPage.tsx`
- [Component manifests](https://github.com/doosemavis/bit-design-system/tree/main/apps/gallery/src/manifests): `apps/gallery/src/manifests`
- [URL control state](https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/engine/useControlState.ts): `apps/gallery/src/engine/useControlState.ts`
- [Preview and controls](https://github.com/doosemavis/bit-design-system/tree/main/apps/gallery/src/engine): `apps/gallery/src/engine`
- [JSX generator](https://github.com/doosemavis/bit-design-system/blob/main/apps/gallery/src/code/toJsx.ts): `apps/gallery/src/code/toJsx.ts`

### React components

- [React package API](https://github.com/doosemavis/bit-design-system/blob/main/packages/react/src/index.ts): `packages/react/src/index.ts`
- [Actions and layout](https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/components): `packages/react/src/components`
- [Form controls](https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/components): `packages/react/src/components`
- [Content and choice](https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/components): `packages/react/src/components`
- [Brand components](https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/logo): `packages/react/src/logo`

### Shared system

- [Color mode](https://github.com/doosemavis/bit-design-system/blob/main/packages/react/src/mode/colorMode.ts): `packages/react/src/mode/colorMode.ts`
- [Class and axis system](https://github.com/doosemavis/bit-design-system/tree/main/packages/react/src/system): `packages/react/src/system`
- [Field context](https://github.com/doosemavis/bit-design-system/blob/main/packages/react/src/components/Field/FieldContext.ts): `packages/react/src/components/Field/FieldContext.ts`

### Tokens and themes

- [Design tokens](https://github.com/doosemavis/bit-design-system/blob/main/packages/core/src/tokens.ts): `packages/core/src/tokens.ts`
- **Theme styles**

### Other components

- **Developer**

## Connections

- Developer → Gallery app: opens (evidence: `README.md`)
- Gallery app → Page routing: renders (evidence: `apps/gallery/src/main.tsx`)
- Page routing → Gallery shell: wraps pages (evidence: `apps/gallery/src/router.tsx`)
- Page routing → Home and tokens: routes to (evidence: `apps/gallery/src/router.tsx`)
- Page routing → Component page: routes to (evidence: `apps/gallery/src/router.tsx`)
- Component page → Component manifests: looks up (evidence: `apps/gallery/src/pages/ComponentPage.tsx`)
- Component page → URL control state: reads state (evidence: `apps/gallery/src/pages/ComponentPage.tsx`)
- URL control state → Component manifests: parses state (evidence: `apps/gallery/src/engine/useControlState.ts`)
- Component page → Preview and controls: renders (evidence: `apps/gallery/src/pages/ComponentPage.tsx`)
- Component page → JSX generator: generates example (evidence: `apps/gallery/src/pages/ComponentPage.tsx`)
- JSX generator → Component manifests: reads definitions (evidence: `apps/gallery/src/code/toJsx.ts`)
- Component page → React package API: uses components (evidence: `apps/gallery/src/pages/ComponentPage.tsx`)
- React package API → Actions and layout: exports (evidence: `packages/react/src/index.ts`)
- React package API → Form controls: exports (evidence: `packages/react/src/index.ts`)
- React package API → Content and choice: exports (evidence: `packages/react/src/index.ts`)
- React package API → Brand components: exports (evidence: `packages/react/src/index.ts`)
- Actions and layout → Class and axis system: builds classes (evidence: `packages/react/src/components/Button/Button.tsx`)
- Form controls → Class and axis system: builds classes (evidence: `packages/react/src/components/SegmentedControl/SegmentedControl.tsx`)
- Content and choice → Class and axis system: builds classes (evidence: `packages/react/src/components/Table/Table.tsx`)
- Form controls → Field context: shares field state (evidence: `packages/react/src/components/Select/Select.tsx`)
- Color mode → Theme styles: sets mode attribute (evidence: `README.md`)
- Class and axis system → Design tokens: uses axes (evidence: `packages/react/src/system/axes.ts`)
- Gallery app → Theme styles: loads styles (evidence: `apps/gallery/src/main.tsx`)
