# chinaeaa/shirone architecture

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

- Interactive diagram: https://gitdiagram.com/chinaeaa/shirone
- Repository: https://github.com/chinaeaa/shirone

## Overview

Shirone is an Astro blog theme for publishing long-form writing and curated personal collections. Authors configure the site and provide Markdown/MDX content; Astro renders pages server-side, with theme components supplying the reading experience and collection views. Markdown extensions, search, feeds, and AI-friendly text endpoints extend the publishing workflow. The README documents the major capabilities, while the sampled source confirms selected configuration, route-registration, music-player, and LLM-text relationships; connections for unsampled page implementations are therefore limited to documented behavior.

Main entry points: [`src/content.config.ts`](https://github.com/chinaeaa/shirone/blob/main/src/content.config.ts) (Blog content), [`src/pages`](https://github.com/chinaeaa/shirone/tree/main/src/pages) (Site pages), [`src/integration/index.ts`](https://github.com/chinaeaa/shirone/blob/main/src/integration/index.ts) (Astro integration), [`src/pages/llms.txt.ts`](https://github.com/chinaeaa/shirone/blob/main/src/pages/llms.txt.ts) (LLM text endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_publishing["Publishing"]
  node_content["Blog content<br/>[content.config.ts]"]
  node_contentutils["Content queries<br/>[content-utils.ts]"]
  node_pages["Site pages"]
  node_collections["Personal collections"]
  node_feeds["RSS and sitemap<br/>[rss.xml.ts]"]
end

subgraph group_theme["Theme Experience"]
  node_components["Theme components"]
  node_i18n["Translations"]
  node_musicplayer["Music sidebar"]
  node_musicruntime["Music runtime<br/>[music-runtime.ts]"]
end

subgraph group_platform["Theme Platform"]
  node_siteconfig["Site settings<br/>[siteConfig.ts]"]
  node_featureconfig["Feature settings"]
  node_overlay["Config overlays<br/>[config-overlay.ts]"]
  node_integration["Astro integration<br/>[index.ts]"]
  node_routes["Route discovery<br/>[routes.ts]"]
  node_fonts["Font integration<br/>[fonts.ts]"]
  node_llmsconfig["LLM settings<br/>[llmsConfig.ts]"]
  node_musicconfig["Music settings<br/>[musicConfig.ts]"]
end

subgraph group_extensions["Content Extensions"]
  node_markdown["Markdown pipeline"]
  node_markdownplugins["Markdown extensions"]
  node_search["Full-text search<br/>[Search.svelte]"]
  node_llmsendpoint["LLM text endpoints<br/>[llms.txt.ts]"]
  node_llmsutils["LLM text generation<br/>[llms-utils.ts]"]
end

node_author(("Site author"))

node_author -->|"configures"| node_siteconfig
node_author -->|"writes"| node_content
node_siteconfig -->|"merges overrides"| node_overlay
node_featureconfig -->|"merges overrides"| node_overlay
node_integration -->|"registers routes"| node_routes
node_integration -->|"loads settings"| node_siteconfig
node_integration -.->|"configures fonts"| node_fonts
node_content -.->|"queries posts"| node_contentutils
node_content -->|"renders Markdown"| node_markdown
node_markdown -->|"applies extensions"| node_markdownplugins
node_pages -->|"reads posts"| node_contentutils
node_pages -->|"renders with"| node_components
node_pages -->|"presents collections"| node_collections
node_components -.->|"uses translations"| node_i18n
node_search -->|"indexes content"| node_content
node_feeds -->|"publishes posts"| node_content
node_llmsendpoint -->|"reads settings"| node_llmsconfig
node_llmsendpoint -->|"loads posts"| node_contentutils
node_llmsendpoint -->|"generates text"| node_llmsutils
node_musicplayer -->|"uses options"| node_musicconfig
node_musicplayer -->|"loads runtime"| node_musicruntime

click node_siteconfig "https://github.com/chinaeaa/shirone/blob/main/src/config/siteConfig.ts"
click node_featureconfig "https://github.com/chinaeaa/shirone/tree/main/src/config"
click node_overlay "https://github.com/chinaeaa/shirone/blob/main/src/utils/config-overlay.ts"
click node_integration "https://github.com/chinaeaa/shirone/blob/main/src/integration/index.ts"
click node_routes "https://github.com/chinaeaa/shirone/blob/main/src/integration/routes.ts"
click node_fonts "https://github.com/chinaeaa/shirone/blob/main/src/integration/fonts.ts"
click node_content "https://github.com/chinaeaa/shirone/blob/main/src/content.config.ts"
click node_contentutils "https://github.com/chinaeaa/shirone/blob/main/src/utils/content-utils.ts"
click node_markdown "https://github.com/chinaeaa/shirone/blob/main/src/utils/markdown-processor.mjs"
click node_markdownplugins "https://github.com/chinaeaa/shirone/tree/main/src/plugins/markdown"
click node_pages "https://github.com/chinaeaa/shirone/tree/main/src/pages"
click node_components "https://github.com/chinaeaa/shirone/tree/main/src/components"
click node_collections "https://github.com/chinaeaa/shirone/tree/main/src/data"
click node_i18n "https://github.com/chinaeaa/shirone/tree/main/src/i18n"
click node_search "https://github.com/chinaeaa/shirone/blob/main/src/components/organisms/Search.svelte"
click node_feeds "https://github.com/chinaeaa/shirone/blob/main/src/pages/rss.xml.ts"
click node_llmsconfig "https://github.com/chinaeaa/shirone/blob/main/src/config/llmsConfig.ts"
click node_llmsendpoint "https://github.com/chinaeaa/shirone/blob/main/src/pages/llms.txt.ts"
click node_llmsutils "https://github.com/chinaeaa/shirone/blob/main/src/utils/llms-utils.ts"
click node_musicconfig "https://github.com/chinaeaa/shirone/blob/main/src/config/musicConfig.ts"
click node_musicplayer "https://github.com/chinaeaa/shirone/blob/main/src/components/organisms/music/MusicSidebarClient.svelte"
click node_musicruntime "https://github.com/chinaeaa/shirone/blob/main/src/utils/music/music-runtime.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_content,node_contentutils,node_pages,node_collections,node_feeds toneBlue
class node_components,node_i18n,node_musicplayer,node_musicruntime toneAmber
class node_siteconfig,node_featureconfig,node_overlay,node_integration,node_routes,node_fonts,node_llmsconfig,node_musicconfig toneMint
class node_markdown,node_markdownplugins,node_search,node_llmsendpoint,node_llmsutils toneRose
class node_author toneIndigo
```

## Components

### Publishing

- [Blog content](https://github.com/chinaeaa/shirone/blob/main/src/content.config.ts): `src/content.config.ts`
- [Content queries](https://github.com/chinaeaa/shirone/blob/main/src/utils/content-utils.ts): `src/utils/content-utils.ts`
- [Site pages](https://github.com/chinaeaa/shirone/tree/main/src/pages): `src/pages`
- [Personal collections](https://github.com/chinaeaa/shirone/tree/main/src/data): `src/data`
- [RSS and sitemap](https://github.com/chinaeaa/shirone/blob/main/src/pages/rss.xml.ts): `src/pages/rss.xml.ts`

### Theme Experience

- [Theme components](https://github.com/chinaeaa/shirone/tree/main/src/components): `src/components`
- [Translations](https://github.com/chinaeaa/shirone/tree/main/src/i18n): `src/i18n`
- [Music sidebar](https://github.com/chinaeaa/shirone/blob/main/src/components/organisms/music/MusicSidebarClient.svelte): `src/components/organisms/music/MusicSidebarClient.svelte`
- [Music runtime](https://github.com/chinaeaa/shirone/blob/main/src/utils/music/music-runtime.ts): `src/utils/music/music-runtime.ts`

### Theme Platform

- [Site settings](https://github.com/chinaeaa/shirone/blob/main/src/config/siteConfig.ts): `src/config/siteConfig.ts`
- [Feature settings](https://github.com/chinaeaa/shirone/tree/main/src/config): `src/config`
- [Config overlays](https://github.com/chinaeaa/shirone/blob/main/src/utils/config-overlay.ts): `src/utils/config-overlay.ts`
- [Astro integration](https://github.com/chinaeaa/shirone/blob/main/src/integration/index.ts): `src/integration/index.ts`
- [Route discovery](https://github.com/chinaeaa/shirone/blob/main/src/integration/routes.ts): `src/integration/routes.ts`
- [Font integration](https://github.com/chinaeaa/shirone/blob/main/src/integration/fonts.ts): `src/integration/fonts.ts`
- [LLM settings](https://github.com/chinaeaa/shirone/blob/main/src/config/llmsConfig.ts): `src/config/llmsConfig.ts`
- [Music settings](https://github.com/chinaeaa/shirone/blob/main/src/config/musicConfig.ts): `src/config/musicConfig.ts`

### Content Extensions

- [Markdown pipeline](https://github.com/chinaeaa/shirone/blob/main/src/utils/markdown-processor.mjs): `src/utils/markdown-processor.mjs`
- [Markdown extensions](https://github.com/chinaeaa/shirone/tree/main/src/plugins/markdown): `src/plugins/markdown`
- [Full-text search](https://github.com/chinaeaa/shirone/blob/main/src/components/organisms/Search.svelte): `src/components/organisms/Search.svelte`
- [LLM text endpoints](https://github.com/chinaeaa/shirone/blob/main/src/pages/llms.txt.ts): `src/pages/llms.txt.ts`
- [LLM text generation](https://github.com/chinaeaa/shirone/blob/main/src/utils/llms-utils.ts): `src/utils/llms-utils.ts`

### Other components

- **Site author**

## Connections

- Site author → Site settings: configures (evidence: `README.md`)
- Site author → Blog content: writes (evidence: `README.md`)
- Site settings → Config overlays: merges overrides
- Feature settings → Config overlays: merges overrides (evidence: `src/config/llmsConfig.ts`)
- Astro integration → Route discovery: registers routes (evidence: `src/integration/index.ts`)
- Astro integration → Site settings: loads settings (evidence: `src/integration/index.ts`)
- Astro integration → Font integration: configures fonts (evidence: `src/integration/index.ts`)
- Blog content → Content queries: queries posts
- Blog content → Markdown pipeline: renders Markdown (evidence: `README.md`)
- Markdown pipeline → Markdown extensions: applies extensions (evidence: `README.md`)
- Site pages → Content queries: reads posts (evidence: `src/pages/llms.txt.ts`)
- Site pages → Theme components: renders with (evidence: `README.md`)
- Site pages → Personal collections: presents collections (evidence: `README.md`)
- Theme components → Translations: uses translations
- Full-text search → Blog content: indexes content (evidence: `README.md`)
- RSS and sitemap → Blog content: publishes posts (evidence: `README.md`)
- LLM text endpoints → LLM settings: reads settings (evidence: `src/pages/llms.txt.ts`)
- LLM text endpoints → Content queries: loads posts (evidence: `src/pages/llms.txt.ts`)
- LLM text endpoints → LLM text generation: generates text (evidence: `src/pages/llms.txt.ts`)
- Music sidebar → Music settings: uses options (evidence: `src/components/organisms/music/MusicSidebarClient.svelte`)
- Music sidebar → Music runtime: loads runtime (evidence: `src/components/organisms/music/MusicSidebarClient.svelte`)
