Visit the live town →  ·  GitHub

---

Welcome to Summer Town! Summer Town is an interactive map of a tiny seaside place. Pan across the waterfront, click into fourteen landmarks, change the time of day, take the ferry tour, then wander Windbell Isle, the town journal, and a visit guide.

What you can do on the map

• Start exploring or take the ferry tour from the arrival screen
• Pan and zoom the isometric town (world canvas: 2400 × 1680)
• Open landmarks for scenes, lore, and sticky facts
• Filter by Culture, Food, Stay, Magic, or Isle
• Repaint the sky with Day, Golden Hour, or Starlight

Landmark	Chip
Town Hall & Central Garden	Heart of Town
The Seashell Theater	Culture
The Gullwing Livehouse	Culture · Night
Nook & Cranny General Store	Food & Goods
The Pearl Gallery	Culture
Café Seabreeze	Food
Summer FM 105.5	On Air
The Tidepool Library	Culture
Paper Boat Design Lab	Make
The Apple Cottage	Food · Home
The Magic House	Magic
Hotel Horizon	Stay
The Three Villas	Stay
Windbell Isle	Isle

Deep links work with ?place=<id> (for example ?place=coffee).

Routes beyond the map

Route	What it is
/	Interactive town map + field notes
/windbell-isle	Scroll journey: pier → meadow → pavilion → sunset → lighthouse
/journal	Passport index, town calendar, postcard wall
/visit	Ferry timetable, stays, etiquette, packing list

Open it

Live

summertown.summercommences.com

Local

npm install
npm run dev

Then open the Vite URL printed in the terminal.

npm run build    # production build → dist/
npm run preview  # preview the production build
npm run lint     # eslint

Stack

React 19 · TypeScript · Vite · Tailwind CSS · Framer Motion · GSAP · Lenis · Howler · shadcn/ui

Deployed to GitHub Pages from main via .github/workflows/deploy.yml (custom domain: summertown.summercommences.com).

Made with

• Vibe coding: Kimi K3 Swarm
• README writing: Cursor Grok 4.5
• README design: beautify-github-readme

Notes

• Best experienced with a mouse or trackpad (custom cursor + map gestures).
• Sound can be toggled from the navbar; respect your own volume.

License

• Source code is released under the MIT License.
• Visual assets under public/ (map art, landmarks, scenes, logos, cursors) are not MIT-licensed. Many were created with AI assistance; please do not reuse them as standalone assets or project branding without permission. See NOTICE.