HANDOFF_README.md

CultureLens / Local in 30s Handoff

This handoff contains the current working version for continuing the Build Small hackathon product.

Preview

Open the offline preview directly:

dist/standalone-preview.html

Run Locally

Install dependencies:

npm.cmd install

Start the dev server:

npm.cmd run dev

Build:

npm.cmd run build

Regenerate the single-file offline preview:

node scripts\make-standalone-preview.mjs

Type check:

npm.cmd run lint

Current UI State

• Compass / Discover page uses src/assets/compass-page.png as the full visual design.
• Compass page has transparent clickable hotspots for snap/upload, Listen buttons, Save to Journey, and the five bottom navigation targets.
• World page uses src/assets/world-page.png; the top world scene, Today discovery card, and Featured discovery section were adjusted.
• Passport page uses src/assets/passport-world-explorer.png.
• Journey saves records through browser localStorage.

Key Files

• src/App.tsx - app shell and navigation.
• src/components/HomeTab.tsx - Compass / Discover page.
• src/components/ExploreTab.tsx - World page.
• src/components/MapTab.tsx - Passport page.
• src/components/JournalTab.tsx - Journey page.
• src/components/ProfileTab.tsx - Traveler page.
• src/data/cultureDecodes.ts - sample culture decode data.
• src/utils/journalStorage.ts - local Journey storage.
• scripts/make-standalone-preview.mjs - creates the offline preview HTML.

Hugging Face Space Note

Direct upload to build-small-hackathon/local-in-30s returned a 403 write-permission error for the available token. A PR upload branch was created earlier, but the Space owner or an org member with write access needs to merge or deploy it.

Excluded From Package

The handoff zip intentionally excludes:

• node_modules
• .npm-cache
• log files
• local snapshot folders
• Python __pycache__