# weiving24/mizuki architecture

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

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

## Overview

Mizuki is an Astro static-blog template. The main reader journey is browsing published posts, using search or categories to find one, then reading it with navigation aids; RSS and special pages provide additional content views. The tree and README establish these capabilities, but many page and content implementations were not sampled, so those links are documented at subsystem level. Sampled source supports the music-player and navigation wiring shown below; other relationships are limited to explicit README statements or source-index references.

Main entry points: [`src/content.config.ts`](https://github.com/weiving24/mizuki/blob/master/src/content.config.ts) (Post content), [`src/scripts/swup-manager.ts`](https://github.com/weiving24/mizuki/blob/master/src/scripts/swup-manager.ts) (Page transitions), [`src/stores/musicPlayerStore.ts`](https://github.com/weiving24/mizuki/blob/master/src/stores/musicPlayerStore.ts) (Music player state), [`src/i18n/translation.ts`](https://github.com/weiving24/mizuki/blob/master/src/i18n/translation.ts) (Translations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content and discovery"]
  node_post_content["Post content<br/>[content.config.ts]"]
  node_content_utils["Content utilities<br/>[content-utils.ts]"]
  node_search["Post search<br/>[Search.svelte]"]
  node_categories["Categories and tags"]
end

subgraph group_pages["Pages and feeds"]
  node_archive["Archive page"]
  node_special_pages["Special pages"]
  node_rss["RSS and Atom"]
  node_calendar_api["Calendar data API"]
end

subgraph group_experience["Reader experience"]
  node_toc["Table of contents<br/>[tocManager.ts]"]
  node_comments["Comments<br/>[commentConfig.ts]"]
  node_transitions["Page transitions<br/>[swup-manager.ts]"]
  node_swup_config["Transition setup<br/>[swup-config.ts]"]
  node_swup_hooks["Transition hooks<br/>[swup-hooks.ts]"]
  node_music_sidebar["Sidebar music UI"]
  node_music_store["Music player state"]
  node_player_hooks["Playlist and audio<br/>[usePlaylist.ts]"]
end

subgraph group_platform["Configuration and runtime"]
  node_nav_config["Navigation settings<br/>[navBarConfig.ts]"]
  node_site_config["Site settings<br/>[siteConfig.ts]"]
  node_widget_manager["Sidebar composition<br/>[widget-manager.ts]"]
  node_translations["Translations<br/>[translation.ts]"]
  node_language_files["Language catalogs"]
  node_navigation_utils["Navigation utilities"]
end

node_reader(("Blog reader"))

node_reader -->|"reads posts"| node_post_content
node_reader -->|"searches posts"| node_search
node_reader -->|"browses topics"| node_categories
node_reader -->|"views archive"| node_archive
node_reader -->|"visits pages"| node_special_pages
node_reader -->|"subscribes to"| node_rss
node_post_content -.->|"processed by"| node_content_utils
node_post_content -->|"gets navigation"| node_toc
node_post_content -->|"may enable"| node_comments
node_reader -.->|"requests calendar"| node_calendar_api
node_transitions -->|"uses setup"| node_swup_config
node_transitions -->|"uses hooks"| node_swup_hooks
node_transitions -->|"uses navigation"| node_navigation_utils
node_widget_manager -->|"reads configuration"| node_site_config
node_music_sidebar -->|"controls player"| node_music_store
node_music_store -->|"reads player settings"| node_site_config
node_player_hooks -->|"localizes messages"| node_translations
node_translations -->|"selects catalog"| node_language_files

click node_post_content "https://github.com/weiving24/mizuki/blob/master/src/content.config.ts"
click node_content_utils "https://github.com/weiving24/mizuki/blob/master/src/utils/content-utils.ts"
click node_search "https://github.com/weiving24/mizuki/blob/master/src/components/organisms/navigation/Search.svelte"
click node_categories "https://github.com/weiving24/mizuki/tree/master/src/components/widgets/categories"
click node_archive "https://github.com/weiving24/mizuki/tree/master/src/components/features/archive"
click node_special_pages "https://github.com/weiving24/mizuki/tree/master/src/components/features"
click node_rss "https://github.com/weiving24/mizuki/tree/master/src/pages"
click node_calendar_api "https://github.com/weiving24/mizuki/blob/master/src/pages/api/calendar-data.json.ts"
click node_toc "https://github.com/weiving24/mizuki/blob/master/src/utils/tocManager.ts"
click node_comments "https://github.com/weiving24/mizuki/blob/master/src/config/commentConfig.ts"
click node_transitions "https://github.com/weiving24/mizuki/blob/master/src/scripts/swup-manager.ts"
click node_swup_config "https://github.com/weiving24/mizuki/blob/master/src/scripts/core/swup-config.ts"
click node_swup_hooks "https://github.com/weiving24/mizuki/blob/master/src/scripts/core/swup-hooks.ts"
click node_nav_config "https://github.com/weiving24/mizuki/blob/master/src/config/navBarConfig.ts"
click node_site_config "https://github.com/weiving24/mizuki/blob/master/src/config/siteConfig.ts"
click node_widget_manager "https://github.com/weiving24/mizuki/blob/master/src/utils/widget-manager.ts"
click node_music_sidebar "https://github.com/weiving24/mizuki/blob/master/src/components/widgets/music-sidebar/SidebarMusicClient.svelte"
click node_music_store "https://github.com/weiving24/mizuki/blob/master/src/stores/musicPlayerStore.ts"
click node_player_hooks "https://github.com/weiving24/mizuki/blob/master/src/components/widgets/music-player/hooks/usePlaylist.ts"
click node_translations "https://github.com/weiving24/mizuki/blob/master/src/i18n/translation.ts"
click node_language_files "https://github.com/weiving24/mizuki/tree/master/src/i18n/languages"
click node_navigation_utils "https://github.com/weiving24/mizuki/blob/master/src/utils/navigation-utils.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_post_content,node_content_utils,node_search,node_categories toneBlue
class node_archive,node_special_pages,node_rss,node_calendar_api toneAmber
class node_toc,node_comments,node_transitions,node_swup_config,node_swup_hooks,node_music_sidebar,node_music_store,node_player_hooks toneMint
class node_nav_config,node_site_config,node_widget_manager,node_translations,node_language_files,node_navigation_utils toneRose
class node_reader toneIndigo
```

## Components

### Content and discovery

- [Post content](https://github.com/weiving24/mizuki/blob/master/src/content.config.ts): `src/content.config.ts`
- [Content utilities](https://github.com/weiving24/mizuki/blob/master/src/utils/content-utils.ts): `src/utils/content-utils.ts`
- [Post search](https://github.com/weiving24/mizuki/blob/master/src/components/organisms/navigation/Search.svelte): `src/components/organisms/navigation/Search.svelte`
- [Categories and tags](https://github.com/weiving24/mizuki/tree/master/src/components/widgets/categories): `src/components/widgets/categories`

### Pages and feeds

- [Archive page](https://github.com/weiving24/mizuki/tree/master/src/components/features/archive): `src/components/features/archive`
- [Special pages](https://github.com/weiving24/mizuki/tree/master/src/components/features): `src/components/features`
- [RSS and Atom](https://github.com/weiving24/mizuki/tree/master/src/pages): `src/pages`
- [Calendar data API](https://github.com/weiving24/mizuki/blob/master/src/pages/api/calendar-data.json.ts): `src/pages/api/calendar-data.json.ts`

### Reader experience

- [Table of contents](https://github.com/weiving24/mizuki/blob/master/src/utils/tocManager.ts): `src/utils/tocManager.ts`
- [Comments](https://github.com/weiving24/mizuki/blob/master/src/config/commentConfig.ts): `src/config/commentConfig.ts`
- [Page transitions](https://github.com/weiving24/mizuki/blob/master/src/scripts/swup-manager.ts): `src/scripts/swup-manager.ts`
- [Transition setup](https://github.com/weiving24/mizuki/blob/master/src/scripts/core/swup-config.ts): `src/scripts/core/swup-config.ts`
- [Transition hooks](https://github.com/weiving24/mizuki/blob/master/src/scripts/core/swup-hooks.ts): `src/scripts/core/swup-hooks.ts`
- [Sidebar music UI](https://github.com/weiving24/mizuki/blob/master/src/components/widgets/music-sidebar/SidebarMusicClient.svelte): `src/components/widgets/music-sidebar/SidebarMusicClient.svelte`
- [Music player state](https://github.com/weiving24/mizuki/blob/master/src/stores/musicPlayerStore.ts): `src/stores/musicPlayerStore.ts`
- [Playlist and audio](https://github.com/weiving24/mizuki/blob/master/src/components/widgets/music-player/hooks/usePlaylist.ts): `src/components/widgets/music-player/hooks/usePlaylist.ts`

### Configuration and runtime

- [Navigation settings](https://github.com/weiving24/mizuki/blob/master/src/config/navBarConfig.ts): `src/config/navBarConfig.ts`
- [Site settings](https://github.com/weiving24/mizuki/blob/master/src/config/siteConfig.ts): `src/config/siteConfig.ts`
- [Sidebar composition](https://github.com/weiving24/mizuki/blob/master/src/utils/widget-manager.ts): `src/utils/widget-manager.ts`
- [Translations](https://github.com/weiving24/mizuki/blob/master/src/i18n/translation.ts): `src/i18n/translation.ts`
- [Language catalogs](https://github.com/weiving24/mizuki/tree/master/src/i18n/languages): `src/i18n/languages`
- [Navigation utilities](https://github.com/weiving24/mizuki/blob/master/src/utils/navigation-utils.ts): `src/utils/navigation-utils.ts`

### Other components

- **Blog reader**

## Connections

- Blog reader → Post content: reads posts (evidence: `README.md`)
- Blog reader → Post search: searches posts (evidence: `README.md`)
- Blog reader → Categories and tags: browses topics (evidence: `README.md`)
- Blog reader → Archive page: views archive (evidence: `README.md`)
- Blog reader → Special pages: visits pages (evidence: `README.md`)
- Blog reader → RSS and Atom: subscribes to (evidence: `README.md`)
- Post content → Content utilities: processed by
- Post content → Table of contents: gets navigation (evidence: `README.md`)
- Post content → Comments: may enable (evidence: `README.md`)
- Blog reader → Calendar data API: requests calendar
- Page transitions → Transition setup: uses setup (evidence: `src/scripts/swup-manager.ts`)
- Page transitions → Transition hooks: uses hooks (evidence: `src/scripts/swup-manager.ts`)
- Page transitions → Navigation utilities: uses navigation (evidence: `src/scripts/swup-manager.ts`)
- Sidebar composition → Site settings: reads configuration (evidence: `src/utils/widget-manager.ts`)
- Sidebar music UI → Music player state: controls player (evidence: `src/components/widgets/music-sidebar/SidebarMusicClient.svelte`)
- Music player state → Site settings: reads player settings (evidence: `src/stores/musicPlayerStore.ts`)
- Playlist and audio → Translations: localizes messages (evidence: `src/components/widgets/music-player/hooks/usePlaylist.ts`)
- Translations → Language catalogs: selects catalog (evidence: `src/i18n/translation.ts`)
