# alonenannan/halo-theme-ethereal architecture

> Architecture diagram of the GitHub repository alonenannan/halo-theme-ethereal, 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/alonenannan/halo-theme-ethereal
- Repository: https://github.com/alonenannan/halo-theme-ethereal

## Overview

Ethereal is a configurable Halo 2 blog theme: visitors browse Halo-rendered pages, with client-side controls and effects enhancing the experience. The README documents broad layout, banner, sidebar, theme, and visual capabilities; sampled source confirms the app initializer’s page-change work, Halo API search, and photo-gallery helpers. Some feature implementations are unsampled, so those branches reflect documented capabilities and use the README as relationship evidence.

Main entry points: [`src/scripts/app.ts`](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/scripts/app.ts) (Client Initializer), [`src/utils/setting-utils.ts`](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/setting-utils.ts) (Setting Utilities), [`src/utils/photos-gallery-lightbox.ts`](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/photos-gallery-lightbox.ts) (Photo Gallery), [`src/pages`](https://github.com/alonenannan/halo-theme-ethereal/tree/main/src/pages) (Page Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rendering["Page Rendering"]
  node_pages["Page Routes"]
  node_layouts["Page Layouts"]
  node_components["Page Components"]
end

subgraph group_experience["Visitor Experience"]
  node_app["Client Initializer<br/>[app.ts]"]
  node_search["Content Search<br/>[Search.svelte]"]
  node_halo_search["Halo Search API"]
  node_scroll["Scroll Behavior<br/>[scroll-manager.ts]"]
  node_banner["Banner Effects<br/>[banner-sync.ts]"]
  node_profile["Profile Status<br/>[profile-status.ts]"]
  node_external_links["Link Handling"]
end

subgraph group_configuration["Theme Configuration"]
  node_theme_switch["Color Scheme"]
  node_settings["Display Settings"]
  node_setting_utils["Setting Utilities<br/>[setting-utils.ts]"]
  node_theme_config["Theme Configuration<br/>[theme-config.ts]"]
end

subgraph group_media["Media Features"]
  node_photo_gallery["Photo Gallery"]
  node_gallery_data["Gallery Data<br/>[gallery-data.ts]"]
  node_gallery_info["Photo Info Panel"]
end

node_visitor(("Visitor"))
node_halo["Halo 2"]

node_visitor -->|"requests pages"| node_halo
node_halo -->|"renders theme routes"| node_pages
node_pages -.->|"use layouts"| node_layouts
node_layouts -->|"compose interface"| node_components
node_visitor -->|"enters keywords"| node_search
node_search -->|"fetches matches"| node_halo_search
node_app -->|"initializes scrolling"| node_scroll
node_app -->|"syncs banner"| node_banner
node_app -->|"initializes gallery"| node_photo_gallery
node_app -->|"initializes links"| node_external_links
node_visitor -->|"changes scheme"| node_theme_switch
node_theme_switch -->|"applies scheme"| node_setting_utils
node_visitor -->|"adjusts display"| node_settings
node_settings -->|"updates preferences"| node_setting_utils
node_setting_utils -.->|"uses configuration"| node_theme_config
node_visitor -->|"opens photos"| node_photo_gallery
node_photo_gallery -->|"reads photo data"| node_gallery_data
node_gallery_info -->|"reads photo metadata"| node_gallery_data
node_visitor -->|"changes status"| node_profile
node_profile -->|"reads status settings"| node_theme_config
node_visitor -->|"views banner effects"| node_banner

click node_pages "https://github.com/alonenannan/halo-theme-ethereal/tree/main/src/pages"
click node_layouts "https://github.com/alonenannan/halo-theme-ethereal/tree/main/src/layouts"
click node_components "https://github.com/alonenannan/halo-theme-ethereal/tree/main/src/components"
click node_app "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/scripts/app.ts"
click node_search "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/components/Search.svelte"
click node_scroll "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/scroll-manager.ts"
click node_theme_switch "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/components/LightDarkSwitch.svelte"
click node_settings "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/components/widget/DisplaySettings.svelte"
click node_setting_utils "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/setting-utils.ts"
click node_theme_config "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/theme-config.ts"
click node_banner "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/banner-sync.ts"
click node_photo_gallery "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/photos-gallery-lightbox.ts"
click node_gallery_data "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/photos/gallery-data.ts"
click node_gallery_info "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/photos/gallery-info-panel.ts"
click node_profile "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/profile-status.ts"
click node_external_links "https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/external-link-redirect.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_pages,node_layouts,node_components toneBlue
class node_app,node_search,node_halo_search,node_scroll,node_banner,node_profile,node_external_links toneAmber
class node_theme_switch,node_settings,node_setting_utils,node_theme_config toneMint
class node_photo_gallery,node_gallery_data,node_gallery_info toneRose
class node_visitor,node_halo toneIndigo
```

## Components

### Page Rendering

- [Page Routes](https://github.com/alonenannan/halo-theme-ethereal/tree/main/src/pages): `src/pages`
- [Page Layouts](https://github.com/alonenannan/halo-theme-ethereal/tree/main/src/layouts): `src/layouts`
- [Page Components](https://github.com/alonenannan/halo-theme-ethereal/tree/main/src/components): `src/components`

### Visitor Experience

- [Client Initializer](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/scripts/app.ts): `src/scripts/app.ts`
- [Content Search](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/components/Search.svelte): `src/components/Search.svelte`
- **Halo Search API**
- [Scroll Behavior](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/scroll-manager.ts): `src/utils/scroll-manager.ts`
- [Banner Effects](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/banner-sync.ts): `src/utils/banner-sync.ts`
- [Profile Status](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/profile-status.ts): `src/utils/profile-status.ts`
- [Link Handling](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/external-link-redirect.ts): `src/utils/external-link-redirect.ts`

### Theme Configuration

- [Color Scheme](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/components/LightDarkSwitch.svelte): `src/components/LightDarkSwitch.svelte`
- [Display Settings](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/components/widget/DisplaySettings.svelte): `src/components/widget/DisplaySettings.svelte`
- [Setting Utilities](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/setting-utils.ts): `src/utils/setting-utils.ts`
- [Theme Configuration](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/theme-config.ts): `src/utils/theme-config.ts`

### Media Features

- [Photo Gallery](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/photos-gallery-lightbox.ts): `src/utils/photos-gallery-lightbox.ts`
- [Gallery Data](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/photos/gallery-data.ts): `src/utils/photos/gallery-data.ts`
- [Photo Info Panel](https://github.com/alonenannan/halo-theme-ethereal/blob/main/src/utils/photos/gallery-info-panel.ts): `src/utils/photos/gallery-info-panel.ts`

### Other components

- **Visitor**
- **Halo 2**

## Connections

- Visitor → Halo 2: requests pages (evidence: `README.md`)
- Halo 2 → Page Routes: renders theme routes (evidence: `README.md`)
- Page Routes → Page Layouts: use layouts
- Page Layouts → Page Components: compose interface (evidence: `README.md`)
- Visitor → Content Search: enters keywords (evidence: `src/components/Search.svelte`)
- Content Search → Halo Search API: fetches matches (evidence: `src/components/Search.svelte`)
- Client Initializer → Scroll Behavior: initializes scrolling (evidence: `src/scripts/app.ts`)
- Client Initializer → Banner Effects: syncs banner (evidence: `src/scripts/app.ts`)
- Client Initializer → Photo Gallery: initializes gallery (evidence: `src/scripts/app.ts`)
- Client Initializer → Link Handling: initializes links (evidence: `src/scripts/app.ts`)
- Visitor → Color Scheme: changes scheme (evidence: `README.md`)
- Color Scheme → Setting Utilities: applies scheme (evidence: `src/components/LightDarkSwitch.svelte`)
- Visitor → Display Settings: adjusts display (evidence: `README.md`)
- Display Settings → Setting Utilities: updates preferences (evidence: `src/components/widget/DisplaySettings.svelte`)
- Setting Utilities → Theme Configuration: uses configuration
- Visitor → Photo Gallery: opens photos (evidence: `README.md`)
- Photo Gallery → Gallery Data: reads photo data (evidence: `src/utils/photos-gallery-lightbox.ts`)
- Photo Info Panel → Gallery Data: reads photo metadata (evidence: `src/utils/photos/gallery-info-panel.ts`)
- Visitor → Profile Status: changes status (evidence: `README.md`)
- Profile Status → Theme Configuration: reads status settings (evidence: `src/utils/profile-status.ts`)
- Visitor → Banner Effects: views banner effects (evidence: `README.md`)
