README.md

August 21, 2026 · View on GitHub

Summer Town — interactive seaside map. Pan the town, open landmarks, and ferry to Windbell Isle.

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.

Summer Town showcase: the interactive map surrounded by landmark scenes including Town Hall, Café Seabreeze, the Magic House, Windbell Isle, and Summer FM.

Explore the map

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).

How a visit works: Arrive, Explore, Step inside, Ferry on.

Wander the pages

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 Summer Town

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.