# lyravoid/mizuki architecture

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

- Interactive diagram: https://gitdiagram.com/lyravoid/mizuki
- Repository: https://github.com/lyravoid/mizuki

## Overview

Mizuki is an Astro-based static personal-blog template. Its main reader workflow is to browse pages rendered from authored posts and structured personal data, then use search, navigation, and feeds to discover or consume that content. The graph also preserves the documented special pages, Markdown enhancements, SEO outputs, comments, and music player. Several links reflect README-level capabilities rather than inspected call sites; those are cited to the README, and unsampled implementation details are not inferred.

Main entry points: [`src/pages`](https://github.com/lyravoid/mizuki/tree/master/src/pages) (Blog pages), [`src/config/navBarConfig.ts`](https://github.com/lyravoid/mizuki/blob/master/src/config/navBarConfig.ts) (Navigation and layout), [`src/stores/musicPlayerStore.ts`](https://github.com/lyravoid/mizuki/blob/master/src/stores/musicPlayerStore.ts) (Music player state), [`src/config/siteConfig.ts`](https://github.com/lyravoid/mizuki/blob/master/src/config/siteConfig.ts) (Site configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content and rendering"]
  node_content_schema["Content schema<br/>[content.config.ts]"]
  node_post_loader["Post loader<br/>[post-loader.ts]"]
  node_markdown_plugins["Markdown extensions"]
  node_structured_data["Personal data"]
end

subgraph group_pages["Reader-facing pages"]
  node_post_pages["Blog pages"]
  node_special_pages["Special pages"]
  node_api_endpoints["Page APIs"]
  node_feeds["RSS and Atom<br/>[rss.xml.ts]"]
  node_seo["SEO outputs<br/>[&#91;...slug&#93;.ts]"]
end

subgraph group_experience["Site experience"]
  node_search["Site search<br/>[Search.svelte]"]
  node_toc["Table of contents<br/>[tocManager.ts]"]
  node_toc_katakana["Japanese heading support"]
  node_navigation["Navigation and layout<br/>[navBarConfig.ts]"]
  node_widget_layout["Sidebar widgets<br/>[widget-manager.ts]"]
  node_transitions["Page transitions<br/>[swup-manager.ts]"]
end

subgraph group_integrations["External integrations"]
  node_comments["Comments<br/>[commentConfig.ts]"]
  node_music_store["Music player state"]
  node_music_audio["Audio playback<br/>[useAudioPlayer.ts]"]
  node_music_sidebar["Music sidebar UI"]
  node_external_services["Optional services"]
end

subgraph group_configuration["Configuration"]
  node_site_config["Site configuration<br/>[siteConfig.ts]"]
  node_config_overrides["Config overrides<br/>[overrideLoader.ts]"]
  node_i18n["Translations<br/>[translation.ts]"]
end

node_reader(("Reader"))
node_authors(("Authors"))

node_authors -->|"author content"| node_content_schema
node_content_schema -.->|"defines posts"| node_post_loader
node_post_loader -.->|"loads content"| node_post_pages
node_post_pages -.->|"renders pages"| node_reader
node_markdown_plugins -->|"extends Markdown"| node_post_pages
node_structured_data -->|"supplies page data"| node_special_pages
node_reader -->|"searches content"| node_search
node_reader -.->|"navigates pages"| node_navigation
node_reader -->|"navigates headings"| node_toc
node_toc -->|"uses heading support"| node_toc_katakana
node_reader -->|"subscribes"| node_feeds
node_feeds -->|"reuses Markdown pipeline"| node_post_pages
node_reader -.->|"requests page data"| node_api_endpoints
node_post_pages -.->|"provides post metadata"| node_seo
node_reader -->|"comments on posts"| node_comments
node_comments -.->|"uses provider"| node_external_services
node_reader -->|"controls playback"| node_music_sidebar
node_music_sidebar -->|"calls player actions"| node_music_store
node_music_store -.->|"controls audio"| node_music_audio
node_music_store -->|"fetches Meting playlist"| node_external_services
node_navigation -.->|"uses site settings"| node_site_config
node_site_config -->|"loads overrides"| node_config_overrides
node_widget_layout -->|"uses widget config"| node_site_config
node_navigation -->|"supports transitions"| node_transitions
node_reader -.->|"uses optional integrations"| node_external_services

click node_content_schema "https://github.com/lyravoid/mizuki/blob/master/src/content.config.ts"
click node_post_loader "https://github.com/lyravoid/mizuki/blob/master/src/loaders/post-loader.ts"
click node_markdown_plugins "https://github.com/lyravoid/mizuki/tree/master/src/plugins"
click node_post_pages "https://github.com/lyravoid/mizuki/tree/master/src/pages"
click node_special_pages "https://github.com/lyravoid/mizuki/tree/master/src/components/features"
click node_structured_data "https://github.com/lyravoid/mizuki/tree/master/src/data"
click node_api_endpoints "https://github.com/lyravoid/mizuki/tree/master/src/pages/api"
click node_search "https://github.com/lyravoid/mizuki/blob/master/src/components/organisms/navigation/Search.svelte"
click node_toc "https://github.com/lyravoid/mizuki/blob/master/src/utils/tocManager.ts"
click node_toc_katakana "https://github.com/lyravoid/mizuki/blob/master/src/components/features/toc/utils/japanese-katakana.ts"
click node_navigation "https://github.com/lyravoid/mizuki/blob/master/src/config/navBarConfig.ts"
click node_widget_layout "https://github.com/lyravoid/mizuki/blob/master/src/utils/widget-manager.ts"
click node_transitions "https://github.com/lyravoid/mizuki/blob/master/src/scripts/swup-manager.ts"
click node_feeds "https://github.com/lyravoid/mizuki/blob/master/src/pages/rss.xml.ts"
click node_seo "https://github.com/lyravoid/mizuki/blob/master/src/pages/og/%5B...slug%5D.ts"
click node_site_config "https://github.com/lyravoid/mizuki/blob/master/src/config/siteConfig.ts"
click node_config_overrides "https://github.com/lyravoid/mizuki/blob/master/src/config/overrideLoader.ts"
click node_i18n "https://github.com/lyravoid/mizuki/blob/master/src/i18n/translation.ts"
click node_comments "https://github.com/lyravoid/mizuki/blob/master/src/config/commentConfig.ts"
click node_music_store "https://github.com/lyravoid/mizuki/blob/master/src/stores/musicPlayerStore.ts"
click node_music_audio "https://github.com/lyravoid/mizuki/blob/master/src/components/widgets/music-player/hooks/useAudioPlayer.ts"
click node_music_sidebar "https://github.com/lyravoid/mizuki/blob/master/src/components/widgets/music-sidebar/SidebarMusicClient.svelte"

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_content_schema,node_post_loader,node_markdown_plugins,node_structured_data toneBlue
class node_post_pages,node_special_pages,node_api_endpoints,node_feeds,node_seo toneAmber
class node_search,node_toc,node_toc_katakana,node_navigation,node_widget_layout,node_transitions toneMint
class node_comments,node_music_store,node_music_audio,node_music_sidebar,node_external_services toneRose
class node_site_config,node_config_overrides,node_i18n,node_reader,node_authors toneIndigo
```

## Components

### Content and rendering

- [Content schema](https://github.com/lyravoid/mizuki/blob/master/src/content.config.ts): `src/content.config.ts`
- [Post loader](https://github.com/lyravoid/mizuki/blob/master/src/loaders/post-loader.ts): `src/loaders/post-loader.ts`
- [Markdown extensions](https://github.com/lyravoid/mizuki/tree/master/src/plugins): `src/plugins`
- [Personal data](https://github.com/lyravoid/mizuki/tree/master/src/data): `src/data`

### Reader-facing pages

- [Blog pages](https://github.com/lyravoid/mizuki/tree/master/src/pages): `src/pages`
- [Special pages](https://github.com/lyravoid/mizuki/tree/master/src/components/features): `src/components/features`
- [Page APIs](https://github.com/lyravoid/mizuki/tree/master/src/pages/api): `src/pages/api`
- [RSS and Atom](https://github.com/lyravoid/mizuki/blob/master/src/pages/rss.xml.ts): `src/pages/rss.xml.ts`
- [SEO outputs](https://github.com/lyravoid/mizuki/blob/master/src/pages/og/%5B...slug%5D.ts): `src/pages/og/[...slug].ts`

### Site experience

- [Site search](https://github.com/lyravoid/mizuki/blob/master/src/components/organisms/navigation/Search.svelte): `src/components/organisms/navigation/Search.svelte`
- [Table of contents](https://github.com/lyravoid/mizuki/blob/master/src/utils/tocManager.ts): `src/utils/tocManager.ts`
- [Japanese heading support](https://github.com/lyravoid/mizuki/blob/master/src/components/features/toc/utils/japanese-katakana.ts): `src/components/features/toc/utils/japanese-katakana.ts`
- [Navigation and layout](https://github.com/lyravoid/mizuki/blob/master/src/config/navBarConfig.ts): `src/config/navBarConfig.ts`
- [Sidebar widgets](https://github.com/lyravoid/mizuki/blob/master/src/utils/widget-manager.ts): `src/utils/widget-manager.ts`
- [Page transitions](https://github.com/lyravoid/mizuki/blob/master/src/scripts/swup-manager.ts): `src/scripts/swup-manager.ts`

### External integrations

- [Comments](https://github.com/lyravoid/mizuki/blob/master/src/config/commentConfig.ts): `src/config/commentConfig.ts`
- [Music player state](https://github.com/lyravoid/mizuki/blob/master/src/stores/musicPlayerStore.ts): `src/stores/musicPlayerStore.ts`
- [Audio playback](https://github.com/lyravoid/mizuki/blob/master/src/components/widgets/music-player/hooks/useAudioPlayer.ts): `src/components/widgets/music-player/hooks/useAudioPlayer.ts`
- [Music sidebar UI](https://github.com/lyravoid/mizuki/blob/master/src/components/widgets/music-sidebar/SidebarMusicClient.svelte): `src/components/widgets/music-sidebar/SidebarMusicClient.svelte`
- **Optional services**

### Configuration

- [Site configuration](https://github.com/lyravoid/mizuki/blob/master/src/config/siteConfig.ts): `src/config/siteConfig.ts`
- [Config overrides](https://github.com/lyravoid/mizuki/blob/master/src/config/overrideLoader.ts): `src/config/overrideLoader.ts`
- [Translations](https://github.com/lyravoid/mizuki/blob/master/src/i18n/translation.ts): `src/i18n/translation.ts`

### Other components

- **Reader**
- **Authors**

## Connections

- Authors → Content schema: author content (evidence: `README.md`)
- Content schema → Post loader: defines posts
- Post loader → Blog pages: loads content
- Blog pages → Reader: renders pages
- Markdown extensions → Blog pages: extends Markdown (evidence: `README.md`)
- Personal data → Special pages: supplies page data (evidence: `README.md`)
- Reader → Site search: searches content (evidence: `README.md`)
- Reader → Navigation and layout: navigates pages
- Reader → Table of contents: navigates headings (evidence: `README.md`)
- Table of contents → Japanese heading support: uses heading support (evidence: `src/utils/tocManager.ts`)
- Reader → RSS and Atom: subscribes (evidence: `README.md`)
- RSS and Atom → Blog pages: reuses Markdown pipeline (evidence: `README.md`)
- Reader → Page APIs: requests page data
- Blog pages → SEO outputs: provides post metadata
- Reader → Comments: comments on posts (evidence: `README.md`)
- Comments → Optional services: uses provider (evidence: `README.md`)
- Reader → Music sidebar UI: controls playback (evidence: `README.md`)
- Music sidebar UI → Music player state: calls player actions (evidence: `src/components/widgets/music-sidebar/SidebarMusicClient.svelte`)
- Music player state → Audio playback: controls audio
- Music player state → Optional services: fetches Meting playlist (evidence: `README.md`)
- Navigation and layout → Site configuration: uses site settings
- Site configuration → Config overrides: loads overrides (evidence: `src/config/index.ts`)
- Sidebar widgets → Site configuration: uses widget config (evidence: `src/utils/widget-manager.ts`)
- Navigation and layout → Page transitions: supports transitions (evidence: `README.md`)
- Reader → Optional services: uses optional integrations (evidence: `README.md`)
