# adityaraj0421/naksha-studio architecture

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

- Interactive diagram: https://gitdiagram.com/adityaraj0421/naksha-studio
- Repository: https://github.com/adityaraj0421/naksha-studio

## Overview

Naksha is a prompt-and-reference design team for coding assistants: users invoke a design task, which draws on specialist guidance to produce design work, audits, and related deliverables. Its separate Naksha Reel package turns extracted design-run beats and screenshots into shareable vertical or landscape videos. The README documents the broader command and platform capabilities; the source excerpts show the reel runtime in detail, but not the command implementations, so those branches are represented at directory level.

Main entry points: [`packages/naksha-reel/bin/render.mjs`](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/bin/render.mjs) (Reel renderer CLI), [`commands`](https://github.com/adityaraj0421/naksha-studio/tree/main/commands) (Slash commands), [`packages/naksha-reel/src/Reel.tsx`](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/Reel.tsx) (Video composition), [`packages/naksha-reel/src/Root.tsx`](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/Root.tsx) (Composition registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_design["Design workflows"]
  node_commands["Slash commands"]
  node_design_work["Design workflows"]
  node_figma["Figma workflows"]
  node_audits["Audits and reviews"]
  node_campaigns["Content and campaigns"]
  node_assistants["Assistant integrations<br/>[.claude-plugin]"]
end

subgraph group_knowledge["Specialist knowledge"]
  node_agents["Specialist agents"]
  node_skill["Design skill<br/>[SKILL.md]"]
  node_references["Design references"]
  node_pipelines["Design pipelines"]
end

subgraph group_reel["Reel rendering"]
  node_reel_command["Reel command<br/>[design-reel.md]"]
  node_render_cli["Reel renderer CLI<br/>[render.mjs]"]
  node_normalizer["Beat normalizer<br/>[normalize.mjs]"]
  node_composition["Video composition<br/>[Reel.tsx]"]
  node_composition_root["Composition registration<br/>[Root.tsx]"]
  node_reel_spec["Preview spec<br/>[spec.ts]"]
  node_reel_ui["Scene UI<br/>[ui.tsx]"]
  node_brand_mark["Naksha mark<br/>[NakshaMark.tsx]"]
  node_theme["Brand theme<br/>[theme.ts]"]
  node_fonts["Font setup<br/>[fonts.ts]"]
  node_entry["Remotion entry<br/>[index.ts]"]
end

node_user(("Designer"))
node_screenshots["Page screenshots"]
node_remotion["Remotion renderer"]
node_video_files["Rendered MP4s"]

node_user -->|"invokes"| node_commands
node_commands -->|"offers"| node_design_work
node_commands -->|"offers"| node_figma
node_commands -->|"offers"| node_audits
node_commands -->|"offers"| node_campaigns
node_skill -->|"loads as needed"| node_references
node_user -->|"uses through"| node_assistants
node_user -->|"invokes"| node_reel_command
node_reel_command -->|"provides render input"| node_render_cli
node_render_cli -->|"normalizes beats"| node_normalizer
node_render_cli -->|"bundles entry"| node_entry
node_render_cli -->|"selects and renders"| node_remotion
node_screenshots -->|"supplies image paths"| node_render_cli
node_render_cli -->|"writes MP4s"| node_video_files
node_entry -->|"registers root"| node_composition_root
node_composition_root -->|"registers compositions"| node_composition
node_composition_root -->|"sets default spec"| node_reel_spec
node_composition -->|"renders scene UI"| node_reel_ui
node_composition -->|"renders mark"| node_brand_mark
node_composition -->|"uses tokens"| node_theme
node_composition -->|"uses font families"| node_fonts
node_reel_ui -->|"uses tokens"| node_theme
node_reel_ui -->|"uses font families"| node_fonts
node_brand_mark -->|"uses tokens"| node_theme

click node_commands "https://github.com/adityaraj0421/naksha-studio/tree/main/commands"
click node_design_work "https://github.com/adityaraj0421/naksha-studio/tree/main/commands"
click node_figma "https://github.com/adityaraj0421/naksha-studio/tree/main/commands"
click node_audits "https://github.com/adityaraj0421/naksha-studio/tree/main/commands"
click node_campaigns "https://github.com/adityaraj0421/naksha-studio/tree/main/commands"
click node_agents "https://github.com/adityaraj0421/naksha-studio/tree/main/agents"
click node_skill "https://github.com/adityaraj0421/naksha-studio/blob/main/skills/design/SKILL.md"
click node_references "https://github.com/adityaraj0421/naksha-studio/tree/main/skills/design/references"
click node_pipelines "https://github.com/adityaraj0421/naksha-studio/tree/main/skills/design/pipelines"
click node_assistants "https://github.com/adityaraj0421/naksha-studio/tree/main/.claude-plugin"
click node_reel_command "https://github.com/adityaraj0421/naksha-studio/blob/main/commands/design-reel.md"
click node_render_cli "https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/bin/render.mjs"
click node_normalizer "https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/normalize.mjs"
click node_composition "https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/Reel.tsx"
click node_composition_root "https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/Root.tsx"
click node_reel_spec "https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/spec.ts"
click node_reel_ui "https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/ui.tsx"
click node_brand_mark "https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/NakshaMark.tsx"
click node_theme "https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/theme.ts"
click node_fonts "https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/fonts.ts"
click node_entry "https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/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_commands,node_design_work,node_figma,node_audits,node_campaigns,node_assistants,node_screenshots toneBlue
class node_agents,node_skill,node_references,node_pipelines toneAmber
class node_reel_command,node_render_cli,node_normalizer,node_composition,node_composition_root,node_reel_spec,node_reel_ui,node_brand_mark,node_theme,node_fonts,node_entry toneMint
class node_user,node_remotion,node_video_files toneIndigo
```

## Components

### Design workflows

- [Slash commands](https://github.com/adityaraj0421/naksha-studio/tree/main/commands): `commands`
- [Design workflows](https://github.com/adityaraj0421/naksha-studio/tree/main/commands): `commands`
- [Figma workflows](https://github.com/adityaraj0421/naksha-studio/tree/main/commands): `commands`
- [Audits and reviews](https://github.com/adityaraj0421/naksha-studio/tree/main/commands): `commands`
- [Content and campaigns](https://github.com/adityaraj0421/naksha-studio/tree/main/commands): `commands`
- [Assistant integrations](https://github.com/adityaraj0421/naksha-studio/tree/main/.claude-plugin): `.claude-plugin`

### Specialist knowledge

- [Specialist agents](https://github.com/adityaraj0421/naksha-studio/tree/main/agents): `agents`
- [Design skill](https://github.com/adityaraj0421/naksha-studio/blob/main/skills/design/SKILL.md): `skills/design/SKILL.md`
- [Design references](https://github.com/adityaraj0421/naksha-studio/tree/main/skills/design/references): `skills/design/references`
- [Design pipelines](https://github.com/adityaraj0421/naksha-studio/tree/main/skills/design/pipelines): `skills/design/pipelines`

### Reel rendering

- [Reel command](https://github.com/adityaraj0421/naksha-studio/blob/main/commands/design-reel.md): `commands/design-reel.md`
- [Reel renderer CLI](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/bin/render.mjs): `packages/naksha-reel/bin/render.mjs`
- [Beat normalizer](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/normalize.mjs): `packages/naksha-reel/src/normalize.mjs`
- [Video composition](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/Reel.tsx): `packages/naksha-reel/src/Reel.tsx`
- [Composition registration](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/Root.tsx): `packages/naksha-reel/src/Root.tsx`
- [Preview spec](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/spec.ts): `packages/naksha-reel/src/spec.ts`
- [Scene UI](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/ui.tsx): `packages/naksha-reel/src/ui.tsx`
- [Naksha mark](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/NakshaMark.tsx): `packages/naksha-reel/src/NakshaMark.tsx`
- [Brand theme](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/theme.ts): `packages/naksha-reel/src/theme.ts`
- [Font setup](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/fonts.ts): `packages/naksha-reel/src/fonts.ts`
- [Remotion entry](https://github.com/adityaraj0421/naksha-studio/blob/main/packages/naksha-reel/src/index.ts): `packages/naksha-reel/src/index.ts`

### Other components

- **Designer**
- **Page screenshots**
- **Remotion renderer**
- **Rendered MP4s**

## Connections

- Designer → Slash commands: invokes (evidence: `README.md`)
- Slash commands → Design workflows: offers (evidence: `README.md`)
- Slash commands → Figma workflows: offers (evidence: `README.md`)
- Slash commands → Audits and reviews: offers (evidence: `README.md`)
- Slash commands → Content and campaigns: offers (evidence: `README.md`)
- Design skill → Design references: loads as needed (evidence: `README.md`)
- Designer → Assistant integrations: uses through (evidence: `README.md`)
- Designer → Reel command: invokes (evidence: `README.md`)
- Reel command → Reel renderer CLI: provides render input (evidence: `packages/naksha-reel/bin/render.mjs`)
- Reel renderer CLI → Beat normalizer: normalizes beats (evidence: `packages/naksha-reel/bin/render.mjs`)
- Reel renderer CLI → Remotion entry: bundles entry (evidence: `packages/naksha-reel/bin/render.mjs`)
- Reel renderer CLI → Remotion renderer: selects and renders (evidence: `packages/naksha-reel/bin/render.mjs`)
- Page screenshots → Reel renderer CLI: supplies image paths (evidence: `packages/naksha-reel/bin/render.mjs`)
- Reel renderer CLI → Rendered MP4s: writes MP4s (evidence: `packages/naksha-reel/bin/render.mjs`)
- Remotion entry → Composition registration: registers root (evidence: `packages/naksha-reel/src/index.ts`)
- Composition registration → Video composition: registers compositions (evidence: `packages/naksha-reel/src/Root.tsx`)
- Composition registration → Preview spec: sets default spec (evidence: `packages/naksha-reel/src/Root.tsx`)
- Video composition → Scene UI: renders scene UI (evidence: `packages/naksha-reel/src/Reel.tsx`)
- Video composition → Naksha mark: renders mark (evidence: `packages/naksha-reel/src/Reel.tsx`)
- Video composition → Brand theme: uses tokens (evidence: `packages/naksha-reel/src/Reel.tsx`)
- Video composition → Font setup: uses font families (evidence: `packages/naksha-reel/src/Reel.tsx`)
- Scene UI → Brand theme: uses tokens (evidence: `packages/naksha-reel/src/ui.tsx`)
- Scene UI → Font setup: uses font families (evidence: `packages/naksha-reel/src/ui.tsx`)
- Naksha mark → Brand theme: uses tokens (evidence: `packages/naksha-reel/src/NakshaMark.tsx`)
