# github-nqvnlc/hbd-01092026 architecture

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

- Interactive diagram: https://gitdiagram.com/github-nqvnlc/hbd-01092026
- Repository: https://github.com/github-nqvnlc/hbd-01092026

## Overview

This is a romantic birthday-greeting website. A visitor opens the welcome overlay, unlocks the interactive page, and explores its celebration, photo gallery, games, and closing letter through one-page navigation. The HTML provides the page structure, CSS its presentation, and the single JavaScript file implements the interactions. The README documents the major features; only excerpts of script.js were supplied, so some feature links rely on that documentation rather than inspected implementation details.

Main entry points: [`index.html`](https://github.com/github-nqvnlc/hbd-01092026/blob/main/index.html) (Birthday Page), [`script.js`](https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js) (Photo Carousel), [`assets/images`](https://github.com/github-nqvnlc/hbd-01092026/tree/main/assets/images) (Memory Photos), [`style.css`](https://github.com/github-nqvnlc/hbd-01092026/blob/main/style.css) (Visual Design)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_welcome["Welcome And Audio"]
  node_welcome["Welcome Overlay<br/>[script.js]"]
  node_audio["Vinyl Music Player<br/>[script.js]"]
end

subgraph group_celebration["Birthday Celebration"]
  node_candle["Birthday Cake<br/>[script.js]"]
  node_wishes["Heartfelt Letter<br/>[index.html]"]
  node_fireworks["Fireworks Effects<br/>[script.js]"]
end

subgraph group_memories["Memories And Games"]
  node_gallery["Photo Carousel<br/>[script.js]"]
  node_photos["Memory Photos"]
  node_lightbox["Photo Lightbox<br/>[script.js]"]
  node_wheel["Lucky Wheel<br/>[script.js]"]
end

subgraph group_page["Page Experience"]
  node_page["Birthday Page<br/>[index.html]"]
  node_styles["Visual Design<br/>[style.css]"]
  node_navigation["Section Navigation<br/>[script.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_page
node_page -->|"uses styles"| node_styles
node_page -->|"starts"| node_welcome
node_visitor -->|"unlocks"| node_welcome
node_visitor -->|"controls"| node_audio
node_visitor -->|"blows candle"| node_candle
node_visitor -->|"spins"| node_wheel
node_visitor -->|"browses"| node_gallery
node_gallery -->|"shows photos"| node_photos
node_gallery -->|"opens"| node_lightbox
node_visitor -->|"reads"| node_wishes
node_visitor -->|"triggers"| node_fireworks
node_visitor -->|"navigates"| node_navigation
node_navigation -->|"changes sections"| node_page

click node_page "https://github.com/github-nqvnlc/hbd-01092026/blob/main/index.html"
click node_styles "https://github.com/github-nqvnlc/hbd-01092026/blob/main/style.css"
click node_welcome "https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js"
click node_audio "https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js"
click node_candle "https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js"
click node_wishes "https://github.com/github-nqvnlc/hbd-01092026/blob/main/index.html"
click node_fireworks "https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js"
click node_gallery "https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js"
click node_photos "https://github.com/github-nqvnlc/hbd-01092026/tree/main/assets/images"
click node_lightbox "https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js"
click node_wheel "https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js"
click node_navigation "https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.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_welcome,node_audio toneBlue
class node_candle,node_wishes,node_fireworks toneAmber
class node_gallery,node_photos,node_lightbox,node_wheel toneMint
class node_page,node_styles,node_navigation toneRose
class node_visitor toneIndigo
```

## Components

### Welcome And Audio

- [Welcome Overlay](https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js): `script.js`
- [Vinyl Music Player](https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js): `script.js`

### Birthday Celebration

- [Birthday Cake](https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js): `script.js`
- [Heartfelt Letter](https://github.com/github-nqvnlc/hbd-01092026/blob/main/index.html): `index.html`
- [Fireworks Effects](https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js): `script.js`

### Memories And Games

- [Photo Carousel](https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js): `script.js`
- [Memory Photos](https://github.com/github-nqvnlc/hbd-01092026/tree/main/assets/images): `assets/images`
- [Photo Lightbox](https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js): `script.js`
- [Lucky Wheel](https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js): `script.js`

### Page Experience

- [Birthday Page](https://github.com/github-nqvnlc/hbd-01092026/blob/main/index.html): `index.html`
- [Visual Design](https://github.com/github-nqvnlc/hbd-01092026/blob/main/style.css): `style.css`
- [Section Navigation](https://github.com/github-nqvnlc/hbd-01092026/blob/main/script.js): `script.js`

### Other components

- **Visitor**

## Connections

- Visitor → Birthday Page: opens (evidence: `README.md`)
- Birthday Page → Visual Design: uses styles (evidence: `README.md`)
- Birthday Page → Welcome Overlay: starts (evidence: `README.md`)
- Visitor → Welcome Overlay: unlocks (evidence: `README.md`)
- Visitor → Vinyl Music Player: controls (evidence: `script.js`)
- Visitor → Birthday Cake: blows candle (evidence: `README.md`)
- Visitor → Lucky Wheel: spins (evidence: `README.md`)
- Visitor → Photo Carousel: browses (evidence: `script.js`)
- Photo Carousel → Memory Photos: shows photos (evidence: `README.md`)
- Photo Carousel → Photo Lightbox: opens (evidence: `script.js`)
- Visitor → Heartfelt Letter: reads (evidence: `README.md`)
- Visitor → Fireworks Effects: triggers (evidence: `script.js`)
- Visitor → Section Navigation: navigates (evidence: `script.js`)
- Section Navigation → Birthday Page: changes sections (evidence: `script.js`)
