Midsummer Web Production

BE SURE YOU WATCH THE REASONS WHY THIS CODE WILL NOT WORK AT https://youtu.be/aN5MMoiUE1M

Vertical-slice web experience for A Midsummer Night's Dream. Built with React + Vite (TypeScript) and designed to host shadcn-based UI, puppeteering controls, and browser-native audio/cutscene systems.

Getting Started

# install deps
npm install

# run the dev server (defaults to http://localhost:3746)
npm run dev

To expose the dev server on the LAN host (e.g. 192.168.4.220:3746), run:

HOST=0.0.0.0 npm run dev

That keeps Vite listening on all interfaces so stakeholders can open the site from another device using http://192.168.4.220:3746.

Project Structure

• src/assets – static assets
• src/components – shadcn/ui components (to be added)
• src/lib – shared helpers (Web Audio orchestration, puppeteering, etc.)
• src/scenes – scene data + orchestration hooks for the vertical slice
• src/views – top-level screens (review shell, tools, dashboards)

Next Steps

1. Install shadcn/ui and seed the core component library.
2. Build the review shell + controls (UND-48).
3. Integrate stage/character systems (UND-45).
4. Wire orchestral cues + sync layer (UND-46).
5. Document the LAN run path in docs/runbooks/lan-review.md (ties to UND-47).

Scripts

• npm run dev – start dev server
• npm run build – production build
• npm run preview – preview the production build locally

Repo housekeeping

• Use git switch -c feature/<slug> per issue.
• Run npm run lint / tests (to be added) before opening PRs.
• Use the PAT documented in TOOLS.md for pushes until a dedicated token is provisioned.