# sasidhar1370/pip-dream-engineer architecture

> Architecture diagram of the GitHub repository sasidhar1370/pip-dream-engineer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sasidhar1370/pip-dream-engineer
- Repository: https://github.com/sasidhar1370/pip-dream-engineer

## Overview

Pip is a browser-based interactive bedtime experience. Visitors explore its story and nursery features, trigger synthesized lullabies and lighting effects, play with stardust, and can leave persistent wishes. The sampled code shows several feature classes and their audio/odometer dependencies; README claims supply the broader feature map. The small Node server serves static files. The excerpt does not show app initialization or all feature implementations, so those connections are limited to documented behavior.

Main entry points: [`app.js`](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js) (Stardust Catcher), [`index.html`](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/index.html) (Nursery Page), [`server.js`](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/server.js) (Static File Server), [`style.css`](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/style.css) (Responsive Themes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Nursery Experience"]
  node_page["Nursery Page<br/>[index.html]"]
  node_visuals["Responsive Themes<br/>[style.css]"]
  node_story["Chapter Storybook<br/>[app.js]"]
  node_dialogue["Bedtime Dialogue<br/>[app.js]"]
  node_effects["Sky &amp; Cursor Effects<br/>[app.js]"]
end

subgraph group_interactions["Interactive Features"]
  node_audio["Audio Manager<br/>[app.js]"]
  node_lullaby["Lullaby Lab<br/>[app.js]"]
  node_lantern["Lantern Beam<br/>[app.js]"]
  node_routes["Dream Routes<br/>[app.js]"]
  node_toy["Stardust Catcher<br/>[app.js]"]
  node_easter["Nightcap Easter Egg<br/>[app.js]"]
  node_odometer["Dream Odometer<br/>[app.js]"]
end

subgraph group_state["Browser State"]
  node_wishwall["Wish Wall<br/>[app.js]"]
  node_visitor_memory["Visitor Memory<br/>[app.js]"]
  node_storage[("Local Storage")]
end

subgraph group_delivery["Web Delivery"]
  node_server["Static File Server<br/>[server.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"explores"| node_page
node_page -.->|"uses styles"| node_visuals
node_visitor -->|"flips chapters"| node_story
node_visitor -->|"chooses prompts"| node_dialogue
node_visitor -->|"plays notes"| node_lullaby
node_lullaby -->|"uses"| node_audio
node_visitor -->|"activates beam"| node_lantern
node_visitor -->|"views telemetry"| node_routes
node_visitor -->|"catches stardust"| node_toy
node_toy -->|"plays chimes"| node_audio
node_toy -->|"awards dreams"| node_odometer
node_visitor -->|"taps nightcap"| node_easter
node_easter -->|"uses"| node_audio
node_easter -->|"uses"| node_odometer
node_visitor -->|"submits wishes"| node_wishwall
node_wishwall -->|"persists wishes"| node_storage
node_visitor_memory -->|"tracks visits"| node_storage
node_odometer -->|"loads count"| node_storage
node_server -->|"serves files"| node_page
node_server -->|"serves files"| node_visuals

click node_page "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/index.html"
click node_visuals "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/style.css"
click node_story "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_dialogue "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_effects "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_audio "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_lullaby "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_lantern "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_routes "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_toy "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_easter "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_odometer "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_wishwall "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_visitor_memory "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js"
click node_server "https://github.com/sasidhar1370/pip-dream-engineer/blob/main/server.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_page,node_visuals,node_story,node_dialogue,node_effects toneBlue
class node_audio,node_lullaby,node_lantern,node_routes,node_toy,node_easter,node_odometer toneAmber
class node_wishwall,node_visitor_memory,node_storage toneMint
class node_server toneRose
class node_visitor toneIndigo
```

## Components

### Nursery Experience

- [Nursery Page](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/index.html): `index.html`
- [Responsive Themes](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/style.css): `style.css`
- [Chapter Storybook](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`
- [Bedtime Dialogue](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`
- [Sky & Cursor Effects](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`

### Interactive Features

- [Audio Manager](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`
- [Lullaby Lab](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`
- [Lantern Beam](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`
- [Dream Routes](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`
- [Stardust Catcher](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`
- [Nightcap Easter Egg](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`
- [Dream Odometer](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`

### Browser State

- [Wish Wall](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`
- [Visitor Memory](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/app.js): `app.js`
- **Local Storage**

### Web Delivery

- [Static File Server](https://github.com/sasidhar1370/pip-dream-engineer/blob/main/server.js): `server.js`

### Other components

- **Visitor**

## Connections

- Visitor → Nursery Page: explores (evidence: `README.md`)
- Nursery Page → Responsive Themes: uses styles
- Visitor → Chapter Storybook: flips chapters (evidence: `README.md`)
- Visitor → Bedtime Dialogue: chooses prompts (evidence: `README.md`)
- Visitor → Lullaby Lab: plays notes (evidence: `README.md`)
- Lullaby Lab → Audio Manager: uses (evidence: `app.js`)
- Visitor → Lantern Beam: activates beam (evidence: `README.md`)
- Visitor → Dream Routes: views telemetry (evidence: `README.md`)
- Visitor → Stardust Catcher: catches stardust (evidence: `README.md`)
- Stardust Catcher → Audio Manager: plays chimes (evidence: `app.js`)
- Stardust Catcher → Dream Odometer: awards dreams (evidence: `app.js`)
- Visitor → Nightcap Easter Egg: taps nightcap (evidence: `README.md`)
- Nightcap Easter Egg → Audio Manager: uses (evidence: `app.js`)
- Nightcap Easter Egg → Dream Odometer: uses (evidence: `app.js`)
- Visitor → Wish Wall: submits wishes (evidence: `README.md`)
- Wish Wall → Local Storage: persists wishes (evidence: `README.md`)
- Visitor Memory → Local Storage: tracks visits (evidence: `README.md`)
- Dream Odometer → Local Storage: loads count (evidence: `app.js`)
- Static File Server → Nursery Page: serves files (evidence: `server.js`)
- Static File Server → Responsive Themes: serves files (evidence: `server.js`)
