# ktumsh/claude-themes architecture

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

- Interactive diagram: https://gitdiagram.com/ktumsh/claude-themes
- Repository: https://github.com/ktumsh/claude-themes

## Overview

Claude Themes is a Claude Code plugin that renders animated SVG backdrops reflecting session usage, work state, and lifecycle events. The principal flow is plugin registration, theme selection, then rendering a scene from shared state and animation helpers; the plugin also supplies theme labels and preview thumbnails. The README documents the signals and scene behavior, while sampled code shows renderer inputs and shared helpers. Some plugin event wiring and renderer dispatch details are unsampled, so those relationships are not expanded beyond documented or indexed references.

Main entry points: [`hooks/register.ts`](https://github.com/ktumsh/claude-themes/blob/main/hooks/register.ts) (Plugin registration), [`hooks`](https://github.com/ktumsh/claude-themes/tree/main/hooks) (17 scene renderers), [`hooks/temas.ts`](https://github.com/ktumsh/claude-themes/blob/main/hooks/temas.ts) (Theme registry), [`hooks/comun.ts`](https://github.com/ktumsh/claude-themes/blob/main/hooks/comun.ts) (Session state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Plugin runtime"]
  node_registration["Plugin registration<br/>[register.ts]"]
  node_theme_registry["Theme registry<br/>[temas.ts]"]
  node_previews["Theme thumbnails<br/>[miniaturas.ts]"]
  node_settings["Theme settings"]
end

subgraph group_rendering["Scene rendering"]
  node_scene_renderers["17 scene renderers"]
  node_color_generator["Color generator<br/>[make-colors.js]"]
end

subgraph group_shared["Shared presentation"]
  node_state_model["Session state<br/>[comun.ts]"]
  node_types["Plugin types<br/>[index.d.ts]"]
  node_text_labels["Theme labels<br/>[textos.ts]"]
end

node_claude(("Claude Code"))

node_claude -.->|"loads plugin"| node_registration
node_registration -->|"imports registry"| node_theme_registry
node_registration -->|"imports labels"| node_text_labels
node_registration -->|"imports thumbnails"| node_previews
node_theme_registry -->|"registers themes"| node_scene_renderers
node_scene_renderers -->|"uses state helpers"| node_state_model
node_state_model -->|"imports types"| node_types
node_claude -.->|"provides session signals"| node_scene_renderers
node_scene_renderers -.->|"renders animated scenes"| node_claude

click node_registration "https://github.com/ktumsh/claude-themes/blob/main/hooks/register.ts"
click node_theme_registry "https://github.com/ktumsh/claude-themes/blob/main/hooks/temas.ts"
click node_state_model "https://github.com/ktumsh/claude-themes/blob/main/hooks/comun.ts"
click node_types "https://github.com/ktumsh/claude-themes/blob/main/types/index.d.ts"
click node_scene_renderers "https://github.com/ktumsh/claude-themes/tree/main/hooks"
click node_text_labels "https://github.com/ktumsh/claude-themes/blob/main/hooks/textos.ts"
click node_previews "https://github.com/ktumsh/claude-themes/blob/main/hooks/miniaturas.ts"
click node_color_generator "https://github.com/ktumsh/claude-themes/blob/main/hooks/make-colors.js"
click node_settings "https://github.com/ktumsh/claude-themes/tree/main/hooks"

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_registration,node_theme_registry,node_previews,node_settings toneBlue
class node_scene_renderers,node_color_generator toneAmber
class node_state_model,node_types,node_text_labels toneMint
class node_claude toneIndigo
```

## Components

### Plugin runtime

- [Plugin registration](https://github.com/ktumsh/claude-themes/blob/main/hooks/register.ts): `hooks/register.ts`
- [Theme registry](https://github.com/ktumsh/claude-themes/blob/main/hooks/temas.ts): `hooks/temas.ts`
- [Theme thumbnails](https://github.com/ktumsh/claude-themes/blob/main/hooks/miniaturas.ts): `hooks/miniaturas.ts`
- [Theme settings](https://github.com/ktumsh/claude-themes/tree/main/hooks): `hooks`

### Scene rendering

- [17 scene renderers](https://github.com/ktumsh/claude-themes/tree/main/hooks): `hooks`
- [Color generator](https://github.com/ktumsh/claude-themes/blob/main/hooks/make-colors.js): `hooks/make-colors.js`

### Shared presentation

- [Session state](https://github.com/ktumsh/claude-themes/blob/main/hooks/comun.ts): `hooks/comun.ts`
- [Plugin types](https://github.com/ktumsh/claude-themes/blob/main/types/index.d.ts): `types/index.d.ts`
- [Theme labels](https://github.com/ktumsh/claude-themes/blob/main/hooks/textos.ts): `hooks/textos.ts`

### Other components

- **Claude Code**

## Connections

- Claude Code → Plugin registration: loads plugin (evidence: `README.md`)
- Plugin registration → Theme registry: imports registry (evidence: `hooks/register.ts`)
- Plugin registration → Theme labels: imports labels (evidence: `hooks/register.ts`)
- Plugin registration → Theme thumbnails: imports thumbnails (evidence: `hooks/register.ts`)
- Theme registry → 17 scene renderers: registers themes (evidence: `hooks/temas.ts`)
- 17 scene renderers → Session state: uses state helpers (evidence: `hooks/acuarela.ts`)
- Session state → Plugin types: imports types (evidence: `hooks/comun.ts`)
- Claude Code → 17 scene renderers: provides session signals (evidence: `README.md`)
- 17 scene renderers → Claude Code: renders animated scenes (evidence: `README.md`)
