# chaosnap/me architecture

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

- Interactive diagram: https://gitdiagram.com/chaosnap/me
- Repository: https://github.com/chaosnap/me

## Overview

週刊ユキ is a Japanese manga-magazine-style personal website. A visitor opens the magazine, browses its chapters by scrolling or using the film navigation, and can inspect portfolio work or submit a reader postcard that opens an email client. The runtime is organized around rendering content, adding motion and interaction, and generating visual and audio effects. The README documents the full chapter set; several chapter implementations are only represented by the shared renderer, so the graph does not imply separate page modules.

Main entry points: [`src/main.js`](https://github.com/chaosnap/me/blob/main/src/main.js) (App bootstrap), [`src/ui.js`](https://github.com/chaosnap/me/blob/main/src/ui.js) (Page interactions), [`src/render.js`](https://github.com/chaosnap/me/blob/main/src/render.js) (Page rendering), [`src/fx/sound.js`](https://github.com/chaosnap/me/blob/main/src/fx/sound.js) (Synthesized sound)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Magazine experience"]
  node_bootstrap["App bootstrap<br/>[main.js]"]
  node_magazine["Magazine chapters<br/>[render.js]"]
  node_portfolio["Portfolio detail<br/>[render.js]"]
  node_reader_postcard["Reader postcard<br/>[ui.js]"]
end

subgraph group_content["Content and rendering"]
  node_content_data["Site content<br/>[content.js]"]
  node_page_rendering["Page rendering<br/>[render.js]"]
  node_generated_art["Generated manga art<br/>[art.js]"]
  node_fonts["Font setup<br/>[fonts.js]"]
end

subgraph group_motion["Navigation and motion"]
  node_scroll_motion["Scroll animation<br/>[anim.js]"]
  node_page_interactions["Page interactions<br/>[ui.js]"]
  node_railway_scene["Railway scene<br/>[railway.js]"]
end

subgraph group_effects["Visual and audio effects"]
  node_sky_shader["Cover sky<br/>[sky.js]"]
  node_jelly_layer["Jellyfish effects<br/>[jelly.js]"]
  node_film_effects["Film effects<br/>[film.js]"]
  node_background_music["Background music<br/>[bgm.js]"]
  node_sound_synthesis["Synthesized sound<br/>[sound.js]"]
  node_fireworks["Fireworks<br/>[fireworks.js]"]
  node_loader_bokeh["Loader bokeh<br/>[bokeh.js]"]
end

node_visitor(("Visitor"))
node_email_client["Email client"]

node_visitor -->|"opens site"| node_bootstrap
node_bootstrap -->|"renders pages"| node_page_rendering
node_page_rendering -->|"reads content"| node_content_data
node_page_rendering -->|"uses artwork"| node_generated_art
node_page_rendering -->|"renders chapters"| node_magazine
node_page_rendering -->|"renders works"| node_portfolio
node_bootstrap -->|"initializes UI"| node_page_interactions
node_page_interactions -->|"uses details"| node_page_rendering
node_page_interactions -->|"reads settings"| node_content_data
node_page_interactions -->|"uses artwork"| node_generated_art
node_page_interactions -->|"uses scrolling"| node_scroll_motion
node_page_interactions -->|"plays cues"| node_sound_synthesis
node_page_interactions -->|"handles form"| node_reader_postcard
node_reader_postcard -->|"opens mailto"| node_email_client
node_bootstrap -->|"starts animation"| node_scroll_motion
node_scroll_motion -->|"initializes loader"| node_loader_bokeh
node_bootstrap -->|"initializes railway"| node_railway_scene
node_railway_scene -->|"plays chimes"| node_sound_synthesis
node_bootstrap -->|"initializes sky"| node_sky_shader
node_bootstrap -->|"creates layers"| node_jelly_layer
node_bootstrap -->|"initializes film"| node_film_effects
node_bootstrap -->|"starts music"| node_background_music
node_bootstrap -->|"creates fireworks"| node_fireworks
node_bootstrap -->|"triggers bursts"| node_sound_synthesis
node_bootstrap -->|"loads fonts"| node_fonts
node_background_music -.->|"uses audio utilities"| node_sound_synthesis

click node_bootstrap "https://github.com/chaosnap/me/blob/main/src/main.js"
click node_magazine "https://github.com/chaosnap/me/blob/main/src/render.js"
click node_portfolio "https://github.com/chaosnap/me/blob/main/src/render.js"
click node_reader_postcard "https://github.com/chaosnap/me/blob/main/src/ui.js"
click node_content_data "https://github.com/chaosnap/me/blob/main/src/content.js"
click node_page_rendering "https://github.com/chaosnap/me/blob/main/src/render.js"
click node_generated_art "https://github.com/chaosnap/me/blob/main/src/art.js"
click node_scroll_motion "https://github.com/chaosnap/me/blob/main/src/anim.js"
click node_page_interactions "https://github.com/chaosnap/me/blob/main/src/ui.js"
click node_railway_scene "https://github.com/chaosnap/me/blob/main/src/railway.js"
click node_sky_shader "https://github.com/chaosnap/me/blob/main/src/fx/sky.js"
click node_jelly_layer "https://github.com/chaosnap/me/blob/main/src/fx/jelly.js"
click node_film_effects "https://github.com/chaosnap/me/blob/main/src/fx/film.js"
click node_background_music "https://github.com/chaosnap/me/blob/main/src/fx/bgm.js"
click node_sound_synthesis "https://github.com/chaosnap/me/blob/main/src/fx/sound.js"
click node_fireworks "https://github.com/chaosnap/me/blob/main/src/fx/fireworks.js"
click node_loader_bokeh "https://github.com/chaosnap/me/blob/main/src/fx/bokeh.js"
click node_fonts "https://github.com/chaosnap/me/blob/main/src/fonts.js"

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_bootstrap,node_magazine,node_portfolio,node_reader_postcard,node_email_client toneBlue
class node_content_data,node_page_rendering,node_generated_art,node_fonts toneAmber
class node_scroll_motion,node_page_interactions,node_railway_scene toneMint
class node_sky_shader,node_jelly_layer,node_film_effects,node_background_music,node_sound_synthesis,node_fireworks,node_loader_bokeh toneRose
class node_visitor toneIndigo
```

## Components

### Magazine experience

- [App bootstrap](https://github.com/chaosnap/me/blob/main/src/main.js): `src/main.js`
- [Magazine chapters](https://github.com/chaosnap/me/blob/main/src/render.js): `src/render.js`
- [Portfolio detail](https://github.com/chaosnap/me/blob/main/src/render.js): `src/render.js`
- [Reader postcard](https://github.com/chaosnap/me/blob/main/src/ui.js): `src/ui.js`

### Content and rendering

- [Site content](https://github.com/chaosnap/me/blob/main/src/content.js): `src/content.js`
- [Page rendering](https://github.com/chaosnap/me/blob/main/src/render.js): `src/render.js`
- [Generated manga art](https://github.com/chaosnap/me/blob/main/src/art.js): `src/art.js`
- [Font setup](https://github.com/chaosnap/me/blob/main/src/fonts.js): `src/fonts.js`

### Navigation and motion

- [Scroll animation](https://github.com/chaosnap/me/blob/main/src/anim.js): `src/anim.js`
- [Page interactions](https://github.com/chaosnap/me/blob/main/src/ui.js): `src/ui.js`
- [Railway scene](https://github.com/chaosnap/me/blob/main/src/railway.js): `src/railway.js`

### Visual and audio effects

- [Cover sky](https://github.com/chaosnap/me/blob/main/src/fx/sky.js): `src/fx/sky.js`
- [Jellyfish effects](https://github.com/chaosnap/me/blob/main/src/fx/jelly.js): `src/fx/jelly.js`
- [Film effects](https://github.com/chaosnap/me/blob/main/src/fx/film.js): `src/fx/film.js`
- [Background music](https://github.com/chaosnap/me/blob/main/src/fx/bgm.js): `src/fx/bgm.js`
- [Synthesized sound](https://github.com/chaosnap/me/blob/main/src/fx/sound.js): `src/fx/sound.js`
- [Fireworks](https://github.com/chaosnap/me/blob/main/src/fx/fireworks.js): `src/fx/fireworks.js`
- [Loader bokeh](https://github.com/chaosnap/me/blob/main/src/fx/bokeh.js): `src/fx/bokeh.js`

### Other components

- **Visitor**
- **Email client**

## Connections

- Visitor → App bootstrap: opens site (evidence: `README.md`)
- App bootstrap → Page rendering: renders pages (evidence: `src/main.js`)
- Page rendering → Site content: reads content (evidence: `src/render.js`)
- Page rendering → Generated manga art: uses artwork (evidence: `src/render.js`)
- Page rendering → Magazine chapters: renders chapters (evidence: `README.md`)
- Page rendering → Portfolio detail: renders works (evidence: `src/render.js`)
- App bootstrap → Page interactions: initializes UI (evidence: `src/main.js`)
- Page interactions → Page rendering: uses details (evidence: `src/ui.js`)
- Page interactions → Site content: reads settings (evidence: `src/ui.js`)
- Page interactions → Generated manga art: uses artwork (evidence: `src/ui.js`)
- Page interactions → Scroll animation: uses scrolling (evidence: `src/ui.js`)
- Page interactions → Synthesized sound: plays cues (evidence: `src/ui.js`)
- Page interactions → Reader postcard: handles form (evidence: `README.md`)
- Reader postcard → Email client: opens mailto (evidence: `src/ui.js`)
- App bootstrap → Scroll animation: starts animation (evidence: `src/main.js`)
- Scroll animation → Loader bokeh: initializes loader (evidence: `src/anim.js`)
- App bootstrap → Railway scene: initializes railway (evidence: `src/main.js`)
- Railway scene → Synthesized sound: plays chimes (evidence: `src/railway.js`)
- App bootstrap → Cover sky: initializes sky (evidence: `src/main.js`)
- App bootstrap → Jellyfish effects: creates layers (evidence: `src/main.js`)
- App bootstrap → Film effects: initializes film (evidence: `src/main.js`)
- App bootstrap → Background music: starts music (evidence: `src/main.js`)
- App bootstrap → Fireworks: creates fireworks (evidence: `src/main.js`)
- App bootstrap → Synthesized sound: triggers bursts (evidence: `src/main.js`)
- App bootstrap → Font setup: loads fonts (evidence: `src/main.js`)
- Background music → Synthesized sound: uses audio utilities (evidence: `src/fx/bgm.js`)
