# lojeevlim/lojee-ui architecture

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

- Interactive diagram: https://gitdiagram.com/lojeevlim/lojee-ui
- Repository: https://github.com/lojeevlim/lojee-ui

## Overview

Lojee UI is a React/TypeScript component library with a parallel custom-element surface and a built-in documentation/demo site. The principal consumer workflow is importing the library API (or registering its custom elements), configuring a theme, and rendering components; the site separately guides visitors from landing and component navigation to live showcases and playgrounds. Shared design tokens underpin the component styling. The README documents themes, animation, data binding, and broad component families; unsampled family internals are represented by their existing directories.

Main entry points: [`src/lib/index.ts`](https://github.com/lojeevlim/lojee-ui/blob/main/src/lib/index.ts) (React API), [`src/elements/register.tsx`](https://github.com/lojeevlim/lojee-ui/blob/main/src/elements/register.tsx) (Element registry), [`src/main.tsx`](https://github.com/lojeevlim/lojee-ui/blob/main/src/main.tsx) (Site router), [`src/App.tsx`](https://github.com/lojeevlim/lojee-ui/blob/main/src/App.tsx) (Component docs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Component library"]
  node_react_api["React API<br/>[index.ts]"]
  node_basic["Core components<br/>[Button.tsx]"]
  node_data_visual["Data visualization"]
  node_forms["Forms and inputs"]
  node_navigation["Navigation and layout"]
  node_feedback["Feedback and overlays"]
end

subgraph group_elements["Web Components"]
  node_elements_entry["Elements entry<br/>[index.ts]"]
  node_element_registry["Element registry<br/>[register.tsx]"]
  node_element_adapters["Element adapters"]
end

subgraph group_site["Docs site"]
  node_site_entry["Site router<br/>[main.tsx]"]
  node_landing["Landing page<br/>[LandingPage.tsx]"]
  node_docs_app["Component docs<br/>[App.tsx]"]
  node_playground["Live playground<br/>[Playground.tsx]"]
  node_showcase["Component showcase"]
  node_code_examples["Code examples<br/>[CodeBlock.tsx]"]
end

subgraph group_shared["Shared design"]
  node_theme["Themes and effects"]
  node_tokens["Design tokens<br/>[tokens.ts]"]
end

node_developer(("Library consumer"))
node_visitor(("Site visitor"))

node_developer -->|"imports"| node_react_api
node_react_api -->|"exports"| node_basic
node_react_api -->|"exports"| node_data_visual
node_react_api -->|"exports"| node_forms
node_react_api -->|"exports"| node_navigation
node_react_api -->|"exports"| node_feedback
node_developer -->|"imports"| node_elements_entry
node_elements_entry -->|"loads"| node_element_registry
node_element_registry -->|"wraps events"| node_element_adapters
node_element_registry -->|"registers"| node_basic
node_visitor -->|"opens site"| node_site_entry
node_site_entry -->|"routes to"| node_landing
node_site_entry -->|"routes to"| node_docs_app
node_docs_app -->|"renders"| node_showcase
node_docs_app -->|"opens"| node_playground
node_showcase -.->|"displays"| node_code_examples
node_basic -->|"styles with"| node_tokens
node_theme -.->|"configures"| node_tokens

click node_react_api "https://github.com/lojeevlim/lojee-ui/blob/main/src/lib/index.ts"
click node_basic "https://github.com/lojeevlim/lojee-ui/blob/main/src/components/ui/Buttons/Button.tsx"
click node_data_visual "https://github.com/lojeevlim/lojee-ui/tree/main/src/components/ui/Map"
click node_forms "https://github.com/lojeevlim/lojee-ui/tree/main/src/components/ui/SearchInput"
click node_navigation "https://github.com/lojeevlim/lojee-ui/tree/main/src/components/ui/AppLayout"
click node_feedback "https://github.com/lojeevlim/lojee-ui/tree/main/src/components/ui/Tooltip"
click node_theme "https://github.com/lojeevlim/lojee-ui/tree/main/src/components/ui/Theme"
click node_tokens "https://github.com/lojeevlim/lojee-ui/blob/main/src/core/tokens.ts"
click node_elements_entry "https://github.com/lojeevlim/lojee-ui/blob/main/src/elements/index.ts"
click node_element_registry "https://github.com/lojeevlim/lojee-ui/blob/main/src/elements/register.tsx"
click node_element_adapters "https://github.com/lojeevlim/lojee-ui/blob/main/src/elements/with-form-events.tsx"
click node_site_entry "https://github.com/lojeevlim/lojee-ui/blob/main/src/main.tsx"
click node_landing "https://github.com/lojeevlim/lojee-ui/blob/main/src/components/landing/LandingPage.tsx"
click node_docs_app "https://github.com/lojeevlim/lojee-ui/blob/main/src/App.tsx"
click node_playground "https://github.com/lojeevlim/lojee-ui/blob/main/src/components/ui/Playground.tsx"
click node_showcase "https://github.com/lojeevlim/lojee-ui/blob/main/src/components/ui/ShowcaseHelpers.tsx"
click node_code_examples "https://github.com/lojeevlim/lojee-ui/blob/main/src/components/ui/CodeBlock.tsx"

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_react_api,node_basic,node_data_visual,node_forms,node_navigation,node_feedback toneBlue
class node_elements_entry,node_element_registry,node_element_adapters toneAmber
class node_site_entry,node_landing,node_docs_app,node_playground,node_showcase,node_code_examples toneMint
class node_theme,node_tokens toneRose
class node_developer,node_visitor toneIndigo
```

## Components

### Component library

- [React API](https://github.com/lojeevlim/lojee-ui/blob/main/src/lib/index.ts): `src/lib/index.ts`
- [Core components](https://github.com/lojeevlim/lojee-ui/blob/main/src/components/ui/Buttons/Button.tsx): `src/components/ui/Buttons/Button.tsx`
- [Data visualization](https://github.com/lojeevlim/lojee-ui/tree/main/src/components/ui/Map): `src/components/ui/Map`
- [Forms and inputs](https://github.com/lojeevlim/lojee-ui/tree/main/src/components/ui/SearchInput): `src/components/ui/SearchInput`
- [Navigation and layout](https://github.com/lojeevlim/lojee-ui/tree/main/src/components/ui/AppLayout): `src/components/ui/AppLayout`
- [Feedback and overlays](https://github.com/lojeevlim/lojee-ui/tree/main/src/components/ui/Tooltip): `src/components/ui/Tooltip`

### Web Components

- [Elements entry](https://github.com/lojeevlim/lojee-ui/blob/main/src/elements/index.ts): `src/elements/index.ts`
- [Element registry](https://github.com/lojeevlim/lojee-ui/blob/main/src/elements/register.tsx): `src/elements/register.tsx`
- [Element adapters](https://github.com/lojeevlim/lojee-ui/blob/main/src/elements/with-form-events.tsx): `src/elements/with-form-events.tsx`

### Docs site

- [Site router](https://github.com/lojeevlim/lojee-ui/blob/main/src/main.tsx): `src/main.tsx`
- [Landing page](https://github.com/lojeevlim/lojee-ui/blob/main/src/components/landing/LandingPage.tsx): `src/components/landing/LandingPage.tsx`
- [Component docs](https://github.com/lojeevlim/lojee-ui/blob/main/src/App.tsx): `src/App.tsx`
- [Live playground](https://github.com/lojeevlim/lojee-ui/blob/main/src/components/ui/Playground.tsx): `src/components/ui/Playground.tsx`
- [Component showcase](https://github.com/lojeevlim/lojee-ui/blob/main/src/components/ui/ShowcaseHelpers.tsx): `src/components/ui/ShowcaseHelpers.tsx`
- [Code examples](https://github.com/lojeevlim/lojee-ui/blob/main/src/components/ui/CodeBlock.tsx): `src/components/ui/CodeBlock.tsx`

### Shared design

- [Themes and effects](https://github.com/lojeevlim/lojee-ui/tree/main/src/components/ui/Theme): `src/components/ui/Theme`
- [Design tokens](https://github.com/lojeevlim/lojee-ui/blob/main/src/core/tokens.ts): `src/core/tokens.ts`

### Other components

- **Library consumer**
- **Site visitor**

## Connections

- Library consumer → React API: imports (evidence: `README.md`)
- React API → Core components: exports (evidence: `src/lib/index.ts`)
- React API → Data visualization: exports (evidence: `src/lib/index.ts`)
- React API → Forms and inputs: exports (evidence: `src/lib/index.ts`)
- React API → Navigation and layout: exports (evidence: `src/lib/index.ts`)
- React API → Feedback and overlays: exports (evidence: `src/lib/index.ts`)
- Library consumer → Elements entry: imports (evidence: `README.md`)
- Elements entry → Element registry: loads (evidence: `src/elements/index.ts`)
- Element registry → Element adapters: wraps events (evidence: `src/elements/register.tsx`)
- Element registry → Core components: registers (evidence: `src/elements/register.tsx`)
- Site visitor → Site router: opens site (evidence: `src/main.tsx`)
- Site router → Landing page: routes to (evidence: `src/main.tsx`)
- Site router → Component docs: routes to (evidence: `src/main.tsx`)
- Component docs → Component showcase: renders (evidence: `src/App.tsx`)
- Component docs → Live playground: opens (evidence: `src/App.tsx`)
- Component showcase → Code examples: displays
- Core components → Design tokens: styles with (evidence: `src/components/ui/Buttons/Button.tsx`)
- Themes and effects → Design tokens: configures
