# denerfernandes/animestudio architecture

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

- Interactive diagram: https://gitdiagram.com/denerfernandes/animestudio
- Repository: https://github.com/denerfernandes/animestudio

## Overview

animeStudio is a deterministic 2D cartoon-animation engine and its web authoring, preview, and video-rendering tools. A typical workflow authors or imports a character document, validates and rigs it, evaluates character or scene animation over time, then renders frames as SVG/React or through Remotion. The repository also documents a director for assembling scenes and sequences, character kits, physics, lighting, effects, and several lip-sync input methods. Connections below follow excerpts, SOURCE INDEX references, or README statements; unsampled implementation details are not asserted.

Main entry points: [`packages/core/src/scene.ts`](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/scene.ts) (Scene evaluation), [`apps/editor/src/App.tsx`](https://github.com/denerfernandes/animestudio/blob/master/apps/editor/src/App.tsx) (Visual editor), [`apps/editor/src/preview.ts`](https://github.com/denerfernandes/animestudio/blob/master/apps/editor/src/preview.ts) (Editor preview), [`packages/core/src/rig.ts`](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/rig.ts) (Rig compilation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring"]
  node_editor["Visual editor<br/>[App.tsx]"]
  node_editor_state["Editor state<br/>[store.ts]"]
  node_editor_doc["Document edits<br/>[doc.ts]"]
  node_editor_preview["Editor preview<br/>[preview.ts]"]
  node_playground["Live playground<br/>[App.tsx]"]
  node_cli["CLI tools<br/>[bin.ts]"]
  node_svg_import["SVG importer<br/>[index.ts]"]
end

subgraph group_engine["Animation engine"]
  node_schema["Document schemas<br/>[schema.ts]"]
  node_validation["Document validation<br/>[validate.ts]"]
  node_rig["Rig compilation<br/>[rig.ts]"]
  node_pose["Pose evaluation<br/>[pose3d.ts]"]
  node_character_anim["Character animation<br/>[fall.ts]"]
  node_scene["Scene evaluation<br/>[scene.ts]"]
end

subgraph group_production["Production extensions"]
  node_director["Scene direction<br/>[direct.ts]"]
  node_character_kits["Character kits<br/>[cartoon.ts]"]
  node_kit_rig["Kit rigs<br/>[rig.ts]"]
  node_lipsync["Lip-sync tools<br/>[node.ts]"]
  node_rigid["Rigid-body physics<br/>[index.ts]"]
  node_lighting["Lighting<br/>[lighting.ts]"]
  node_effects["Cartoon effects<br/>[fx.ts]"]
end

subgraph group_outputs["Render and export"]
  node_svg_render["SVG rendering<br/>[render.ts]"]
  node_react_render["React renderer<br/>[index.tsx]"]
  node_remotion["Remotion adapter<br/>[index.tsx]"]
  node_video_app["Video project<br/>[Root.tsx]"]
end

node_artist(("Artist"))

node_artist -->|"authors in"| node_editor
node_editor -->|"dispatches edits"| node_editor_state
node_editor -->|"edits documents"| node_editor_doc
node_editor -->|"validates input"| node_validation
node_editor -->|"requests preview"| node_editor_preview
node_editor_preview -->|"compiles rig"| node_rig
node_editor_preview -->|"compiles scene"| node_scene
node_editor_preview -->|"evaluates pose"| node_pose
node_editor_preview -->|"renders character"| node_svg_render
node_playground -->|"validates character"| node_validation
node_playground -->|"compiles and evaluates"| node_scene
node_playground -->|"bakes bodies"| node_rigid
node_playground -->|"renders frame"| node_react_render
node_cli -->|"checks documents"| node_validation
node_cli -->|"imports artwork"| node_svg_import
node_cli -->|"runs lip sync"| node_lipsync
node_svg_import -->|"produces character"| node_rig
node_validation -->|"validates against"| node_schema
node_scene -->|"compiles actors"| node_rig
node_scene -->|"renders characters"| node_svg_render
node_scene -->|"evaluates lighting"| node_lighting
node_scene -->|"generates effects"| node_effects
node_scene -->|"uses text cues"| node_lipsync
node_rig -->|"compiles 3D rig"| node_pose
node_director -->|"compiles and evaluates"| node_scene
node_director -->|"stages kit characters"| node_character_kits
node_character_kits -->|"uses kit rig"| node_kit_rig
node_character_kits -->|"uses core geometry"| node_rig
node_lipsync -.->|"provides cues"| node_scene
node_rigid -.->|"bakes scene bodies"| node_scene
node_scene -->|"frames for display"| node_react_render
node_remotion -->|"uses renderer"| node_react_render
node_remotion -->|"uses physics"| node_rigid
node_video_app -->|"builds composition"| node_remotion
node_video_app -->|"loads scene assets"| node_scene
node_svg_render -.->|"exports through adapter"| node_remotion
node_character_anim -.->|"supports actions"| node_scene

click node_editor "https://github.com/denerfernandes/animestudio/blob/master/apps/editor/src/App.tsx"
click node_editor_state "https://github.com/denerfernandes/animestudio/blob/master/apps/editor/src/store.ts"
click node_editor_doc "https://github.com/denerfernandes/animestudio/blob/master/apps/editor/src/doc.ts"
click node_editor_preview "https://github.com/denerfernandes/animestudio/blob/master/apps/editor/src/preview.ts"
click node_playground "https://github.com/denerfernandes/animestudio/blob/master/apps/playground/src/App.tsx"
click node_cli "https://github.com/denerfernandes/animestudio/blob/master/packages/cli/src/bin.ts"
click node_svg_import "https://github.com/denerfernandes/animestudio/blob/master/packages/import-svg/src/index.ts"
click node_schema "https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/format/schema.ts"
click node_validation "https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/format/validate.ts"
click node_rig "https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/rig.ts"
click node_pose "https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/pose3d.ts"
click node_character_anim "https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/fall.ts"
click node_scene "https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/scene.ts"
click node_director "https://github.com/denerfernandes/animestudio/blob/master/packages/director/src/direct.ts"
click node_character_kits "https://github.com/denerfernandes/animestudio/blob/master/packages/kit/src/cartoon.ts"
click node_kit_rig "https://github.com/denerfernandes/animestudio/blob/master/packages/kit/src/rig.ts"
click node_lipsync "https://github.com/denerfernandes/animestudio/blob/master/packages/lipsync/src/node.ts"
click node_rigid "https://github.com/denerfernandes/animestudio/blob/master/packages/rigid/src/index.ts"
click node_lighting "https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/lighting.ts"
click node_effects "https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/fx.ts"
click node_svg_render "https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/render.ts"
click node_react_render "https://github.com/denerfernandes/animestudio/blob/master/packages/react/src/index.tsx"
click node_remotion "https://github.com/denerfernandes/animestudio/blob/master/packages/remotion/src/index.tsx"
click node_video_app "https://github.com/denerfernandes/animestudio/blob/master/apps/video/src/Root.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_editor,node_editor_state,node_editor_doc,node_editor_preview,node_playground,node_cli,node_svg_import toneBlue
class node_schema,node_validation,node_rig,node_pose,node_character_anim,node_scene toneAmber
class node_director,node_character_kits,node_kit_rig,node_lipsync,node_rigid,node_lighting,node_effects toneMint
class node_svg_render,node_react_render,node_remotion,node_video_app toneRose
class node_artist toneIndigo
```

## Components

### Authoring

- [Visual editor](https://github.com/denerfernandes/animestudio/blob/master/apps/editor/src/App.tsx): `apps/editor/src/App.tsx`
- [Editor state](https://github.com/denerfernandes/animestudio/blob/master/apps/editor/src/store.ts): `apps/editor/src/store.ts`
- [Document edits](https://github.com/denerfernandes/animestudio/blob/master/apps/editor/src/doc.ts): `apps/editor/src/doc.ts`
- [Editor preview](https://github.com/denerfernandes/animestudio/blob/master/apps/editor/src/preview.ts): `apps/editor/src/preview.ts`
- [Live playground](https://github.com/denerfernandes/animestudio/blob/master/apps/playground/src/App.tsx): `apps/playground/src/App.tsx`
- [CLI tools](https://github.com/denerfernandes/animestudio/blob/master/packages/cli/src/bin.ts): `packages/cli/src/bin.ts`
- [SVG importer](https://github.com/denerfernandes/animestudio/blob/master/packages/import-svg/src/index.ts): `packages/import-svg/src/index.ts`

### Animation engine

- [Document schemas](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/format/schema.ts): `packages/core/src/format/schema.ts`
- [Document validation](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/format/validate.ts): `packages/core/src/format/validate.ts`
- [Rig compilation](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/rig.ts): `packages/core/src/rig.ts`
- [Pose evaluation](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/pose3d.ts): `packages/core/src/pose3d.ts`
- [Character animation](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/fall.ts): `packages/core/src/fall.ts`
- [Scene evaluation](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/scene.ts): `packages/core/src/scene.ts`

### Production extensions

- [Scene direction](https://github.com/denerfernandes/animestudio/blob/master/packages/director/src/direct.ts): `packages/director/src/direct.ts`
- [Character kits](https://github.com/denerfernandes/animestudio/blob/master/packages/kit/src/cartoon.ts): `packages/kit/src/cartoon.ts`
- [Kit rigs](https://github.com/denerfernandes/animestudio/blob/master/packages/kit/src/rig.ts): `packages/kit/src/rig.ts`
- [Lip-sync tools](https://github.com/denerfernandes/animestudio/blob/master/packages/lipsync/src/node.ts): `packages/lipsync/src/node.ts`
- [Rigid-body physics](https://github.com/denerfernandes/animestudio/blob/master/packages/rigid/src/index.ts): `packages/rigid/src/index.ts`
- [Lighting](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/lighting.ts): `packages/core/src/lighting.ts`
- [Cartoon effects](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/fx.ts): `packages/core/src/fx.ts`

### Render and export

- [SVG rendering](https://github.com/denerfernandes/animestudio/blob/master/packages/core/src/render.ts): `packages/core/src/render.ts`
- [React renderer](https://github.com/denerfernandes/animestudio/blob/master/packages/react/src/index.tsx): `packages/react/src/index.tsx`
- [Remotion adapter](https://github.com/denerfernandes/animestudio/blob/master/packages/remotion/src/index.tsx): `packages/remotion/src/index.tsx`
- [Video project](https://github.com/denerfernandes/animestudio/blob/master/apps/video/src/Root.tsx): `apps/video/src/Root.tsx`

### Other components

- **Artist**

## Connections

- Artist → Visual editor: authors in
- Visual editor → Editor state: dispatches edits (evidence: `apps/editor/src/App.tsx`)
- Visual editor → Document edits: edits documents (evidence: `apps/editor/src/App.tsx`)
- Visual editor → Document validation: validates input (evidence: `apps/editor/src/App.tsx`)
- Visual editor → Editor preview: requests preview (evidence: `apps/editor/src/App.tsx`)
- Editor preview → Rig compilation: compiles rig (evidence: `apps/editor/src/preview.ts`)
- Editor preview → Scene evaluation: compiles scene (evidence: `apps/editor/src/preview.ts`)
- Editor preview → Pose evaluation: evaluates pose (evidence: `apps/editor/src/preview.ts`)
- Editor preview → SVG rendering: renders character (evidence: `apps/editor/src/preview.ts`)
- Live playground → Document validation: validates character (evidence: `apps/playground/src/App.tsx`)
- Live playground → Scene evaluation: compiles and evaluates (evidence: `apps/playground/src/App.tsx`)
- Live playground → Rigid-body physics: bakes bodies (evidence: `apps/playground/src/App.tsx`)
- Live playground → React renderer: renders frame (evidence: `apps/playground/src/App.tsx`)
- CLI tools → Document validation: checks documents (evidence: `packages/cli/src/bin.ts`)
- CLI tools → SVG importer: imports artwork (evidence: `packages/cli/src/bin.ts`)
- CLI tools → Lip-sync tools: runs lip sync (evidence: `packages/cli/src/bin.ts`)
- SVG importer → Rig compilation: produces character (evidence: `packages/import-svg/src/index.ts`)
- Document validation → Document schemas: validates against (evidence: `packages/core/src/format/validate.ts`)
- Scene evaluation → Rig compilation: compiles actors (evidence: `packages/core/src/scene.ts`)
- Scene evaluation → SVG rendering: renders characters (evidence: `packages/core/src/scene.ts`)
- Scene evaluation → Lighting: evaluates lighting (evidence: `packages/core/src/scene.ts`)
- Scene evaluation → Cartoon effects: generates effects (evidence: `packages/core/src/scene.ts`)
- Scene evaluation → Lip-sync tools: uses text cues (evidence: `packages/core/src/scene.ts`)
- Rig compilation → Pose evaluation: compiles 3D rig (evidence: `packages/core/src/rig.ts`)
- Scene direction → Scene evaluation: compiles and evaluates (evidence: `packages/director/src/direct.ts`)
- Scene direction → Character kits: stages kit characters (evidence: `packages/director/src/direct.ts`)
- Character kits → Kit rigs: uses kit rig (evidence: `packages/kit/src/cartoon.ts`)
- Character kits → Rig compilation: uses core geometry (evidence: `packages/kit/src/cartoon.ts`)
- Lip-sync tools → Scene evaluation: provides cues
- Rigid-body physics → Scene evaluation: bakes scene bodies
- Scene evaluation → React renderer: frames for display
- Remotion adapter → React renderer: uses renderer (evidence: `packages/remotion/src/index.tsx`)
- Remotion adapter → Rigid-body physics: uses physics (evidence: `packages/remotion/src/index.tsx`)
- Video project → Remotion adapter: builds composition (evidence: `apps/video/src/Root.tsx`)
- Video project → Scene evaluation: loads scene assets (evidence: `apps/video/src/Root.tsx`)
- SVG rendering → Remotion adapter: exports through adapter
- Character animation → Scene evaluation: supports actions (evidence: `packages/core/src/scene.ts`)
