# sudokrishna/goltui architecture

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

- Interactive diagram: https://gitdiagram.com/sudokrishna/goltui
- Repository: https://github.com/sudokrishna/goltui

## Overview

goltUI is a copy-paste React and Tailwind component catalog, not a runtime dependency. Users can browse the website’s component and block pages, then run the self-contained CLI in their own project to copy source and install required dependencies. The graph preserves the documented catalog branches and representative implementation layers. Relationships for unsampled features are based on README statements; source excerpts additionally show selected internal calls, including microphone audio analysis and orb rendering.

Main entry points: [`packages/cli/registry`](https://github.com/sudokrishna/goltui/tree/main/packages/cli/registry) (Bundled Registry), [`packages/cli/bin/goltui.js`](https://github.com/sudokrishna/goltui/blob/main/packages/cli/bin/goltui.js) (goltui CLI), [`packages/cli/registry/thinking-orbs/ThinkingOrb.tsx`](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/thinking-orbs/ThinkingOrb.tsx) (Thinking Orb), [`packages/cli/registry/voice-glow/VoiceBeam.tsx`](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/voice-glow/VoiceBeam.tsx) (Voice Beam)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_website["Website Catalog"]
  node_site["Gallery Site<br/>[page.tsx]"]
  node_component_docs["Component Pages"]
  node_block_pages["Block Pages"]
  node_previews["Live Previews"]
  node_play["Orb Catcher<br/>[page.tsx]"]
  node_catalog_data["Block Categories"]
end

subgraph group_catalog["Component Source"]
  node_buttons_inputs["Buttons and Inputs<br/>[input-mic.tsx]"]
  node_auth_headers["Auth and Headers<br/>[header-01.tsx]"]
  node_heroes_logos["Heroes and Logos"]
  node_text_motion["Text and Scroll"]
end

subgraph group_cli["CLI Installation"]
  node_cli_entry["goltui CLI<br/>[goltui.js]"]
  node_registry["Bundled Registry"]
end

subgraph group_effects["Interactive Effects"]
  node_border_beam["Border Beam<br/>[BorderBeam.tsx]"]
  node_beam_styles["Beam Styles<br/>[styles.ts]"]
  node_thinking_orb["Thinking Orb<br/>[ThinkingOrb.tsx]"]
  node_orb_engine["Orb Engine<br/>[core.ts]"]
  node_orb_gravity["Orb Gravity<br/>[gravity.ts]"]
  node_voice_beam["Voice Beam<br/>[VoiceBeam.tsx]"]
  node_microphone["Microphone Hook<br/>[useMicrophone.ts]"]
  node_audio["Audio Analysis<br/>[audio.ts]"]
  node_voice_driver["Voice Driver<br/>[voiceDriver.ts]"]
end

node_user(("Developer"))
node_project_files["Project Files"]
node_package_manager["Package Manager"]

node_user -->|"browse catalog"| node_site
node_user -->|"inspect components"| node_component_docs
node_user -->|"browse blocks"| node_block_pages
node_user -->|"view previews"| node_previews
node_user -->|"play game"| node_play
node_user -->|"run add"| node_cli_entry
node_cli_entry -->|"look up source"| node_registry
node_cli_entry -->|"copy source"| node_project_files
node_cli_entry -->|"install dependencies"| node_package_manager
node_registry -.->|"provides source"| node_buttons_inputs
node_registry -.->|"provides source"| node_auth_headers
node_registry -.->|"provides source"| node_heroes_logos
node_registry -.->|"provides source"| node_text_motion
node_registry -.->|"provides source"| node_border_beam
node_registry -.->|"provides source"| node_thinking_orb
node_registry -.->|"provides source"| node_voice_beam
node_border_beam -->|"uses presets"| node_beam_styles
node_thinking_orb -->|"renders frames"| node_orb_engine
node_thinking_orb -->|"attaches effect"| node_orb_gravity
node_microphone -->|"starts context"| node_audio
node_voice_driver -->|"acquires analyser"| node_audio
node_voice_beam -.->|"uses input"| node_microphone
node_voice_beam -.->|"drives animation"| node_voice_driver
node_catalog_data -.->|"categorizes blocks"| node_block_pages

click node_site "https://github.com/sudokrishna/goltui/blob/main/apps/web/src/app/page.tsx"
click node_component_docs "https://github.com/sudokrishna/goltui/tree/main/apps/web/src/app/components"
click node_block_pages "https://github.com/sudokrishna/goltui/tree/main/apps/web/src/app/blocks"
click node_previews "https://github.com/sudokrishna/goltui/tree/main/apps/web/src/app/preview"
click node_play "https://github.com/sudokrishna/goltui/blob/main/apps/web/src/app/play/page.tsx"
click node_catalog_data "https://github.com/sudokrishna/goltui/blob/main/apps/web/src/lib/block-categories.ts"
click node_cli_entry "https://github.com/sudokrishna/goltui/blob/main/packages/cli/bin/goltui.js"
click node_registry "https://github.com/sudokrishna/goltui/tree/main/packages/cli/registry"
click node_buttons_inputs "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/input-mic.tsx"
click node_auth_headers "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/header-01.tsx"
click node_heroes_logos "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/plane-window-hero/PlaneWindowHero.tsx"
click node_text_motion "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/text-scroll/TextScrollAnimation.tsx"
click node_border_beam "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/border-beam/BorderBeam.tsx"
click node_beam_styles "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/border-beam/styles.ts"
click node_thinking_orb "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/thinking-orbs/ThinkingOrb.tsx"
click node_orb_engine "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/thinking-orbs/engine/core.ts"
click node_orb_gravity "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/thinking-orbs/gravity.ts"
click node_voice_beam "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/voice-glow/VoiceBeam.tsx"
click node_microphone "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/voice-glow/useMicrophone.ts"
click node_audio "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/voice-glow/audio.ts"
click node_voice_driver "https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/voice-glow/voiceDriver.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_site,node_component_docs,node_block_pages,node_previews,node_play,node_catalog_data toneBlue
class node_buttons_inputs,node_auth_headers,node_heroes_logos,node_text_motion toneAmber
class node_cli_entry,node_registry toneMint
class node_border_beam,node_beam_styles,node_thinking_orb,node_orb_engine,node_orb_gravity,node_voice_beam,node_microphone,node_audio,node_voice_driver toneRose
class node_user,node_project_files,node_package_manager toneIndigo
```

## Components

### Website Catalog

- [Gallery Site](https://github.com/sudokrishna/goltui/blob/main/apps/web/src/app/page.tsx): `apps/web/src/app/page.tsx`
- [Component Pages](https://github.com/sudokrishna/goltui/tree/main/apps/web/src/app/components): `apps/web/src/app/components`
- [Block Pages](https://github.com/sudokrishna/goltui/tree/main/apps/web/src/app/blocks): `apps/web/src/app/blocks`
- [Live Previews](https://github.com/sudokrishna/goltui/tree/main/apps/web/src/app/preview): `apps/web/src/app/preview`
- [Orb Catcher](https://github.com/sudokrishna/goltui/blob/main/apps/web/src/app/play/page.tsx): `apps/web/src/app/play/page.tsx`
- [Block Categories](https://github.com/sudokrishna/goltui/blob/main/apps/web/src/lib/block-categories.ts): `apps/web/src/lib/block-categories.ts`

### Component Source

- [Buttons and Inputs](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/input-mic.tsx): `packages/cli/registry/input-mic.tsx`
- [Auth and Headers](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/header-01.tsx): `packages/cli/registry/header-01.tsx`
- [Heroes and Logos](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/plane-window-hero/PlaneWindowHero.tsx): `packages/cli/registry/plane-window-hero/PlaneWindowHero.tsx`
- [Text and Scroll](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/text-scroll/TextScrollAnimation.tsx): `packages/cli/registry/text-scroll/TextScrollAnimation.tsx`

### CLI Installation

- [goltui CLI](https://github.com/sudokrishna/goltui/blob/main/packages/cli/bin/goltui.js): `packages/cli/bin/goltui.js`
- [Bundled Registry](https://github.com/sudokrishna/goltui/tree/main/packages/cli/registry): `packages/cli/registry`

### Interactive Effects

- [Border Beam](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/border-beam/BorderBeam.tsx): `packages/cli/registry/border-beam/BorderBeam.tsx`
- [Beam Styles](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/border-beam/styles.ts): `packages/cli/registry/border-beam/styles.ts`
- [Thinking Orb](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/thinking-orbs/ThinkingOrb.tsx): `packages/cli/registry/thinking-orbs/ThinkingOrb.tsx`
- [Orb Engine](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/thinking-orbs/engine/core.ts): `packages/cli/registry/thinking-orbs/engine/core.ts`
- [Orb Gravity](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/thinking-orbs/gravity.ts): `packages/cli/registry/thinking-orbs/gravity.ts`
- [Voice Beam](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/voice-glow/VoiceBeam.tsx): `packages/cli/registry/voice-glow/VoiceBeam.tsx`
- [Microphone Hook](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/voice-glow/useMicrophone.ts): `packages/cli/registry/voice-glow/useMicrophone.ts`
- [Audio Analysis](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/voice-glow/audio.ts): `packages/cli/registry/voice-glow/audio.ts`
- [Voice Driver](https://github.com/sudokrishna/goltui/blob/main/packages/cli/registry/voice-glow/voiceDriver.ts): `packages/cli/registry/voice-glow/voiceDriver.ts`

### Other components

- **Developer**
- **Project Files**
- **Package Manager**

## Connections

- Developer → Gallery Site: browse catalog (evidence: `README.md`)
- Developer → Component Pages: inspect components (evidence: `README.md`)
- Developer → Block Pages: browse blocks (evidence: `README.md`)
- Developer → Live Previews: view previews (evidence: `README.md`)
- Developer → Orb Catcher: play game (evidence: `README.md`)
- Developer → goltui CLI: run add (evidence: `README.md`)
- goltui CLI → Bundled Registry: look up source (evidence: `README.md`)
- goltui CLI → Project Files: copy source (evidence: `README.md`)
- goltui CLI → Package Manager: install dependencies (evidence: `README.md`)
- Bundled Registry → Buttons and Inputs: provides source
- Bundled Registry → Auth and Headers: provides source
- Bundled Registry → Heroes and Logos: provides source (evidence: `packages/cli/registry/plane-window-hero/PlaneWindowHero.tsx`)
- Bundled Registry → Text and Scroll: provides source (evidence: `packages/cli/registry/text-scroll/TextScrollAnimation.tsx`)
- Bundled Registry → Border Beam: provides source (evidence: `packages/cli/registry/border-beam/BorderBeam.tsx`)
- Bundled Registry → Thinking Orb: provides source (evidence: `packages/cli/registry/thinking-orbs/ThinkingOrb.tsx`)
- Bundled Registry → Voice Beam: provides source
- Border Beam → Beam Styles: uses presets (evidence: `packages/cli/registry/border-beam/BorderBeam.tsx`)
- Thinking Orb → Orb Engine: renders frames (evidence: `packages/cli/registry/thinking-orbs/ThinkingOrb.tsx`)
- Thinking Orb → Orb Gravity: attaches effect (evidence: `packages/cli/registry/thinking-orbs/ThinkingOrb.tsx`)
- Microphone Hook → Audio Analysis: starts context (evidence: `packages/cli/registry/voice-glow/useMicrophone.ts`)
- Voice Driver → Audio Analysis: acquires analyser (evidence: `packages/cli/registry/voice-glow/voiceDriver.ts`)
- Voice Beam → Microphone Hook: uses input
- Voice Beam → Voice Driver: drives animation
- Block Categories → Block Pages: categorizes blocks
