# somajitkhatua/didi_birthday architecture

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

- Interactive diagram: https://gitdiagram.com/somajitkhatua/didi_birthday
- Repository: https://github.com/somajitkhatua/didi_birthday

## Overview

This repository is a small, browser-only static site for a birthday experience (“didi_birthday”). There is no evidence of a server, database, build pipeline, or external backend integration in the repo; the architecture is centered on a handful of HTML pages that share one JavaScript file and one stylesheet.

1. **Top-level structure**
   - The app is split into five HTML documents: `index.html`, `gallery.html`, `messages.html`, `quiz.html`, and `timeline.html`.
   - Shared assets live in `style.css` and `script.js`.
   - `README.md` only names the project, so the repository itself is the primary source of architecture.

2. **Primary entry point**
   - `index.html` is the most likely landing page and hub for navigation.
   - The other pages are feature-specific destinations rather than separate applications.

3. **Page-level feature modules**
   - `gallery.html` likely presents photos or memories.
   - `messages.html` likely contains birthday notes or greetings.
   - `quiz.html` likely hosts an interactive quiz.
   - `timeline.html` likely shows a chronological birthday/story timeline.
   - Each page represents a self-contained view, but they are part of one cohesive site.

4. **Shared presentation layer**
   - `style.css` provides the visual design system used across all pages.
   - This implies a consistent look-and-feel and shared layout patterns across the entire site.
   - The CSS file is the main boundary for global styling concerns.

5. **Shared behavior layer**
   - `script.js` is the single shared JavaScript runtime for the site.
   - It likely handles cross-page interactions such as navigation behavior, animations, quiz logic, or dynamic content rendering.
   - Because there is only one JS file, behavior is centralized rather than split into page-specific bundles.

6. **Data and content flow**
   - Content appears to be embedded directly in the HTML files or managed by the shared script, rather than fetched from an API.
   - The browser loads a page, applies shared CSS, and executes shared JS locally.
   - User interaction stays in the client; no networked data layer is visible from the repository structure.

7. **Navigation model**
   - The architecture is multi-page rather than a single-page application.
   - Moving between “gallery,” “messages,” “quiz,” and “timeline” likely means full page navigation between HTML files.
   - This makes the site simple to deploy and easy to reason about: each page is an independent document, but all share common assets.

8. **Functional boundaries**
   - Visual design: `style.css`
   - Interactive behavior: `script.js`
   - Content/views: the individual `.html` files
   - This separation is the main architectural boundary in the repo.

9. **Runtime and deployment characteristics**
   - The site runs entirely in the browser.
   - It can likely be hosted as static files on any simple web host or file server.
   - There are no signs of server-side rendering, authentication, persistence, or API orchestration.

10. **What an architecture diagram should show**
   - A user/browser at the top.
   - A static site layer containing the five HTML pages.
   - Shared assets (`style.css`, `script.js`) connected to every page.
   - One-way flow from browser to static files, with client-side interaction handled locally.

Overall, this is a straightforward static multi-page birthday microsite: shared styling and behavior, multiple themed content pages, and no visible backend or infrastructure beyond static hosting.

Main entry points: [`index.html`](https://github.com/somajitkhatua/didi_birthday/blob/main/index.html) (Home), [`style.css`](https://github.com/somajitkhatua/didi_birthday/blob/main/style.css) (Styles), [`script.js`](https://github.com/somajitkhatua/didi_birthday/blob/main/script.js) (Script), [`gallery.html`](https://github.com/somajitkhatua/didi_birthday/blob/main/gallery.html) (Gallery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_pages["Pages"]
  node_index_html["Home<br/>entry page<br/>[index.html]"]
  node_gallery_html["Gallery<br/>content page<br/>[gallery.html]"]
  node_messages_html["Messages<br/>content page<br/>[messages.html]"]
  node_quiz_html["Quiz<br/>interactive page<br/>[quiz.html]"]
  node_timeline_html["Timeline<br/>content page<br/>[timeline.html]"]
end

subgraph group_group_shared["Shared assets"]
  node_style_css["Styles<br/>shared css<br/>[style.css]"]
  node_script_js["Script<br/>shared js<br/>[script.js]"]
end

node_browser(("Browser<br/>client"))

node_browser -->|"opens"| node_index_html
node_browser -->|"opens"| node_gallery_html
node_browser -->|"opens"| node_messages_html
node_browser -->|"opens"| node_quiz_html
node_browser -->|"opens"| node_timeline_html
node_index_html -->|"links"| node_gallery_html
node_index_html -->|"links"| node_messages_html
node_index_html -->|"links"| node_quiz_html
node_index_html -->|"links"| node_timeline_html
node_index_html -->|"uses"| node_style_css
node_index_html -->|"uses"| node_script_js
node_gallery_html -->|"uses"| node_style_css
node_gallery_html -->|"uses"| node_script_js
node_messages_html -->|"uses"| node_style_css
node_messages_html -->|"uses"| node_script_js
node_quiz_html -->|"uses"| node_style_css
node_quiz_html -->|"uses"| node_script_js
node_timeline_html -->|"uses"| node_style_css
node_timeline_html -->|"uses"| node_script_js

click node_index_html "https://github.com/somajitkhatua/didi_birthday/blob/main/index.html"
click node_gallery_html "https://github.com/somajitkhatua/didi_birthday/blob/main/gallery.html"
click node_messages_html "https://github.com/somajitkhatua/didi_birthday/blob/main/messages.html"
click node_quiz_html "https://github.com/somajitkhatua/didi_birthday/blob/main/quiz.html"
click node_timeline_html "https://github.com/somajitkhatua/didi_birthday/blob/main/timeline.html"
click node_style_css "https://github.com/somajitkhatua/didi_birthday/blob/main/style.css"
click node_script_js "https://github.com/somajitkhatua/didi_birthday/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_index_html,node_gallery_html,node_messages_html,node_quiz_html,node_timeline_html toneBlue
class node_style_css,node_script_js toneAmber
class node_browser toneNeutral
```

## Components

### Pages

Static HTML views that make up the birthday microsite.

- [Home](https://github.com/somajitkhatua/didi_birthday/blob/main/index.html): entry page · Landing page and navigation hub for the microsite. · `index.html`
- [Gallery](https://github.com/somajitkhatua/didi_birthday/blob/main/gallery.html): content page · Photo or memory-focused page. · `gallery.html`
- [Messages](https://github.com/somajitkhatua/didi_birthday/blob/main/messages.html): content page · Birthday notes and greetings page. · `messages.html`
- [Quiz](https://github.com/somajitkhatua/didi_birthday/blob/main/quiz.html): interactive page · Page with birthday quiz interactions. · `quiz.html`
- [Timeline](https://github.com/somajitkhatua/didi_birthday/blob/main/timeline.html): content page · Chronological story or event timeline page. · `timeline.html`

### Shared assets

Global styling and browser-side behavior used by every page.

- [Styles](https://github.com/somajitkhatua/didi_birthday/blob/main/style.css): shared css · Global presentation layer shared across all pages. · `style.css`
- [Script](https://github.com/somajitkhatua/didi_birthday/blob/main/script.js): shared js · Central browser-side behavior for the site. · `script.js`

### Other components

- **Browser**: client · User-facing runtime that loads the static site and handles interaction locally.

## Connections

- Browser → Home: opens · Primary entry point for the site.
- Browser → Gallery: opens · Browser can navigate directly to the gallery page.
- Browser → Messages: opens · Browser can navigate directly to the messages page.
- Browser → Quiz: opens · Browser can navigate directly to the quiz page.
- Browser → Timeline: opens · Browser can navigate directly to the timeline page.
- Home → Gallery: links · Home page provides navigation to the gallery.
- Home → Messages: links · Home page provides navigation to messages.
- Home → Quiz: links · Home page provides navigation to the quiz.
- Home → Timeline: links · Home page provides navigation to the timeline.
- Home → Styles: uses · Shared styling applied to the landing page.
- Home → Script: uses · Shared behavior used on the landing page.
- Gallery → Styles: uses · Shared styling applied to the gallery page.
- Gallery → Script: uses · Shared behavior used on the gallery page.
- Messages → Styles: uses · Shared styling applied to the messages page.
- Messages → Script: uses · Shared behavior used on the messages page.
- Quiz → Styles: uses · Shared styling applied to the quiz page.
- Quiz → Script: uses · Shared behavior used on the quiz page.
- Timeline → Styles: uses · Shared styling applied to the timeline page.
- Timeline → Script: uses · Shared behavior used on the timeline page.
