# m3-org/characterstudio architecture

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

- Interactive diagram: https://gitdiagram.com/m3-org/characterstudio
- Repository: https://github.com/m3-org/characterstudio

## Overview

Character Studio is a browser-based 3D avatar creator and asset workflow tool. Users enter the studio, load or choose avatar assets, customize traits and animation, then export avatars or use batch, optimization, wallet, and minting features. The React app selects views while shared scene state initializes and exposes the character manager; it is the internal layer connecting editor interactions to avatar operations. Relationships for unsampled pages and capabilities are included only where documented; some implementation details and integrations could not be verified from the excerpts.

Main entry points: [`src/App.jsx`](https://github.com/m3-org/characterstudio/blob/main/src/App.jsx) (Application views), [`src/pages/Appearance.jsx`](https://github.com/m3-org/characterstudio/blob/main/src/pages/Appearance.jsx) (Appearance editor), [`src/library/download-utils.js`](https://github.com/m3-org/characterstudio/blob/main/src/library/download-utils.js) (Avatar export), [`src/library/characterManager.js`](https://github.com/m3-org/characterstudio/blob/main/src/library/characterManager.js) (Character manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Studio app"]
  node_entry["Application views<br/>[App.jsx]"]
  node_view["View state<br/>[ViewContext.jsx]"]
  node_language["Language state"]
  node_audio["Audio controls<br/>[AudioContext.jsx]"]
  node_sound["Sound effects<br/>[SoundContext.jsx]"]
end

subgraph group_editor["Avatar editing"]
  node_appearance["Appearance editor<br/>[Appearance.jsx]"]
  node_filedrop["Asset drop"]
  node_attributes["Trait attributes<br/>[JsonAttributes.jsx]"]
  node_displaymenu["Editor controls"]
end

subgraph group_runtime["3D runtime"]
  node_scene["Scene state<br/>[SceneContext.jsx]"]
  node_character["Character manager"]
  node_animation["Animation manager"]
  node_manifest["Manifest data"]
  node_load["Model loading<br/>[load-utils.js]"]
end

subgraph group_export["Export and batch"]
  node_save["Avatar export<br/>[download-utils.js]"]
  node_vrmexport["VRM exporter<br/>[VRMExporter.js]"]
  node_merge["Mesh merging<br/>[merge-geometry.js]"]
  node_batch["Batch export<br/>[BatchDownload.jsx]"]
  node_batchmanifest["Manifest batch<br/>[BatchManifest.jsx]"]
  node_mergeoptions["Merge options<br/>[MergeOptions.jsx]"]
  node_optimizer["Avatar optimizer<br/>[Optimizer.jsx]"]
end

subgraph group_web3["Wallet and minting"]
  node_mint["Mint workflow<br/>[mint-utils.js]"]
  node_contract["Contract interface<br/>[Contract.jsx]"]
  node_wallet["Wallet workflow<br/>[Wallet.jsx]"]
end

node_user(("Studio user"))
node_chain{{"Blockchain service"}}

node_user -->|"uses"| node_entry
node_entry -->|"selects views"| node_view
node_entry -->|"renders"| node_appearance
node_entry -->|"renders"| node_batch
node_entry -->|"renders"| node_batchmanifest
node_appearance -->|"renders"| node_filedrop
node_appearance -->|"renders"| node_attributes
node_appearance -->|"renders"| node_displaymenu
node_appearance -->|"reads state"| node_scene
node_appearance -->|"loads animation"| node_animation
node_scene -->|"initializes"| node_character
node_scene -.->|"provides data"| node_manifest
node_character -->|"owns manager"| node_animation
node_character -->|"loads model data"| node_load
node_character -->|"exports avatar"| node_save
node_save -->|"uses exporter"| node_vrmexport
node_save -->|"merges meshes"| node_merge
node_user -->|"optimizes avatar"| node_optimizer
node_optimizer -.->|"merges meshes"| node_merge
node_batch -->|"exports assets"| node_save
node_batchmanifest -.->|"uses metadata"| node_manifest
node_user -.->|"mints avatar"| node_mint
node_mint -->|"prepares export"| node_save
node_mint -->|"calls contract"| node_contract
node_contract -.->|"interacts with"| node_chain
node_user -.->|"manages assets"| node_wallet
node_entry -->|"renders"| node_wallet
node_user -.->|"changes language"| node_language
node_user -.->|"controls music"| node_audio
node_user -.->|"hears effects"| node_sound

click node_entry "https://github.com/m3-org/characterstudio/blob/main/src/App.jsx"
click node_view "https://github.com/m3-org/characterstudio/blob/main/src/context/ViewContext.jsx"
click node_language "https://github.com/m3-org/characterstudio/blob/main/src/context/LanguageContext.jsx"
click node_audio "https://github.com/m3-org/characterstudio/blob/main/src/context/AudioContext.jsx"
click node_sound "https://github.com/m3-org/characterstudio/blob/main/src/context/SoundContext.jsx"
click node_appearance "https://github.com/m3-org/characterstudio/blob/main/src/pages/Appearance.jsx"
click node_filedrop "https://github.com/m3-org/characterstudio/blob/main/src/components/FileDropComponent.jsx"
click node_attributes "https://github.com/m3-org/characterstudio/blob/main/src/components/JsonAttributes.jsx"
click node_displaymenu "https://github.com/m3-org/characterstudio/blob/main/src/components/BottomDisplayMenu.jsx"
click node_scene "https://github.com/m3-org/characterstudio/blob/main/src/context/SceneContext.jsx"
click node_character "https://github.com/m3-org/characterstudio/blob/main/src/library/characterManager.js"
click node_animation "https://github.com/m3-org/characterstudio/blob/main/src/library/animationManager.js"
click node_manifest "https://github.com/m3-org/characterstudio/blob/main/src/library/CharacterManifestData.js"
click node_load "https://github.com/m3-org/characterstudio/blob/main/src/library/load-utils.js"
click node_save "https://github.com/m3-org/characterstudio/blob/main/src/library/download-utils.js"
click node_vrmexport "https://github.com/m3-org/characterstudio/blob/main/src/library/VRMExporter.js"
click node_merge "https://github.com/m3-org/characterstudio/blob/main/src/library/merge-geometry.js"
click node_batch "https://github.com/m3-org/characterstudio/blob/main/src/pages/BatchDownload.jsx"
click node_batchmanifest "https://github.com/m3-org/characterstudio/blob/main/src/pages/BatchManifest.jsx"
click node_mergeoptions "https://github.com/m3-org/characterstudio/blob/main/src/components/MergeOptions.jsx"
click node_optimizer "https://github.com/m3-org/characterstudio/blob/main/src/pages/Optimizer.jsx"
click node_mint "https://github.com/m3-org/characterstudio/blob/main/src/library/mint-utils.js"
click node_contract "https://github.com/m3-org/characterstudio/blob/main/src/components/Contract.jsx"
click node_wallet "https://github.com/m3-org/characterstudio/blob/main/src/pages/Wallet.jsx"

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_entry,node_view,node_language,node_audio,node_sound,node_user toneBlue
class node_appearance,node_filedrop,node_attributes,node_displaymenu toneAmber
class node_scene,node_character,node_animation,node_manifest,node_load toneMint
class node_save,node_vrmexport,node_merge,node_batch,node_batchmanifest,node_mergeoptions,node_optimizer toneRose
class node_mint,node_contract,node_wallet,node_chain toneIndigo
```

## Components

### Studio app

- [Application views](https://github.com/m3-org/characterstudio/blob/main/src/App.jsx): `src/App.jsx`
- [View state](https://github.com/m3-org/characterstudio/blob/main/src/context/ViewContext.jsx): `src/context/ViewContext.jsx`
- [Language state](https://github.com/m3-org/characterstudio/blob/main/src/context/LanguageContext.jsx): `src/context/LanguageContext.jsx`
- [Audio controls](https://github.com/m3-org/characterstudio/blob/main/src/context/AudioContext.jsx): `src/context/AudioContext.jsx`
- [Sound effects](https://github.com/m3-org/characterstudio/blob/main/src/context/SoundContext.jsx): `src/context/SoundContext.jsx`

### Avatar editing

- [Appearance editor](https://github.com/m3-org/characterstudio/blob/main/src/pages/Appearance.jsx): `src/pages/Appearance.jsx`
- [Asset drop](https://github.com/m3-org/characterstudio/blob/main/src/components/FileDropComponent.jsx): `src/components/FileDropComponent.jsx`
- [Trait attributes](https://github.com/m3-org/characterstudio/blob/main/src/components/JsonAttributes.jsx): `src/components/JsonAttributes.jsx`
- [Editor controls](https://github.com/m3-org/characterstudio/blob/main/src/components/BottomDisplayMenu.jsx): `src/components/BottomDisplayMenu.jsx`

### 3D runtime

- [Scene state](https://github.com/m3-org/characterstudio/blob/main/src/context/SceneContext.jsx): `src/context/SceneContext.jsx`
- [Character manager](https://github.com/m3-org/characterstudio/blob/main/src/library/characterManager.js): `src/library/characterManager.js`
- [Animation manager](https://github.com/m3-org/characterstudio/blob/main/src/library/animationManager.js): `src/library/animationManager.js`
- [Manifest data](https://github.com/m3-org/characterstudio/blob/main/src/library/CharacterManifestData.js): `src/library/CharacterManifestData.js`
- [Model loading](https://github.com/m3-org/characterstudio/blob/main/src/library/load-utils.js): `src/library/load-utils.js`

### Export and batch

- [Avatar export](https://github.com/m3-org/characterstudio/blob/main/src/library/download-utils.js): `src/library/download-utils.js`
- [VRM exporter](https://github.com/m3-org/characterstudio/blob/main/src/library/VRMExporter.js): `src/library/VRMExporter.js`
- [Mesh merging](https://github.com/m3-org/characterstudio/blob/main/src/library/merge-geometry.js): `src/library/merge-geometry.js`
- [Batch export](https://github.com/m3-org/characterstudio/blob/main/src/pages/BatchDownload.jsx): `src/pages/BatchDownload.jsx`
- [Manifest batch](https://github.com/m3-org/characterstudio/blob/main/src/pages/BatchManifest.jsx): `src/pages/BatchManifest.jsx`
- [Merge options](https://github.com/m3-org/characterstudio/blob/main/src/components/MergeOptions.jsx): `src/components/MergeOptions.jsx`
- [Avatar optimizer](https://github.com/m3-org/characterstudio/blob/main/src/pages/Optimizer.jsx): `src/pages/Optimizer.jsx`

### Wallet and minting

- [Mint workflow](https://github.com/m3-org/characterstudio/blob/main/src/library/mint-utils.js): `src/library/mint-utils.js`
- [Contract interface](https://github.com/m3-org/characterstudio/blob/main/src/components/Contract.jsx): `src/components/Contract.jsx`
- [Wallet workflow](https://github.com/m3-org/characterstudio/blob/main/src/pages/Wallet.jsx): `src/pages/Wallet.jsx`

### Other components

- **Studio user**
- **Blockchain service**

## Connections

- Studio user → Application views: uses (evidence: `README.md`)
- Application views → View state: selects views (evidence: `src/App.jsx`)
- Application views → Appearance editor: renders (evidence: `src/App.jsx`)
- Application views → Batch export: renders (evidence: `src/App.jsx`)
- Application views → Manifest batch: renders (evidence: `src/App.jsx`)
- Appearance editor → Asset drop: renders (evidence: `src/pages/Appearance.jsx`)
- Appearance editor → Trait attributes: renders (evidence: `src/pages/Appearance.jsx`)
- Appearance editor → Editor controls: renders (evidence: `src/pages/Appearance.jsx`)
- Appearance editor → Scene state: reads state (evidence: `src/pages/Appearance.jsx`)
- Appearance editor → Animation manager: loads animation (evidence: `src/pages/Appearance.jsx`)
- Scene state → Character manager: initializes (evidence: `src/context/SceneContext.jsx`)
- Scene state → Manifest data: provides data
- Character manager → Animation manager: owns manager (evidence: `src/library/characterManager.js`)
- Character manager → Model loading: loads model data (evidence: `src/library/characterManager.js`)
- Character manager → Avatar export: exports avatar (evidence: `src/library/characterManager.js`)
- Avatar export → VRM exporter: uses exporter (evidence: `src/library/download-utils.js`)
- Avatar export → Mesh merging: merges meshes (evidence: `src/library/download-utils.js`)
- Studio user → Avatar optimizer: optimizes avatar (evidence: `README.md`)
- Avatar optimizer → Mesh merging: merges meshes
- Batch export → Avatar export: exports assets (evidence: `src/pages/BatchDownload.jsx`)
- Manifest batch → Manifest data: uses metadata
- Studio user → Mint workflow: mints avatar
- Mint workflow → Avatar export: prepares export (evidence: `src/library/mint-utils.js`)
- Mint workflow → Contract interface: calls contract (evidence: `src/library/mint-utils.js`)
- Contract interface → Blockchain service: interacts with
- Studio user → Wallet workflow: manages assets
- Application views → Wallet workflow: renders (evidence: `src/App.jsx`)
- Studio user → Language state: changes language
- Studio user → Audio controls: controls music
- Studio user → Sound effects: hears effects
