v1.2.0 - Multi-Platform Installation Guide

🗺 Map of Us v1.2.0

Local-first couple's memory map desktop app — mark every city you've visited together.

✨ Features

• 🗺 Interactive China SVG map (34 provinces) with D3-geo projection
• 📸 City memories with multi-photo covers
• 🔐 Dual-layer password protection (HMAC-SHA256)
• ⚙️ Settings (anniversaries, weather cities, couple logo, login photos)
• 💾 Full backup/restore
• 🖥️ Electron desktop app (macOS + Windows)
• 🌐 Web deployment with Supabase
• 🧪 Vitest test suite (24+ tests)

📦 Installation

Electron Desktop App (Recommended)

macOS

1. Download the .dmg file from Releases
2. Double-click to install
3. Right-click → Open (first launch only)
4. Default password: 1234 / Admin: admin1234

Windows

1. Download the -Setup.exe file from Releases
2. Run the installer
3. If SmartScreen appears: More info → Run anyway
4. Default password: 1234 / Admin: admin1234

Linux

git clone https://github.com/WuSuBuDuoMing/map.git
cd map
npm install
npm run desktop

Web Development Mode (All Platforms)

git clone https://github.com/WuSuBuDuoMing/map.git
cd map
npm install
npm run dev
# Open http://localhost:3002

Docker

docker build -t map-of-us .
docker run -p 3002:3002 map-of-us

🏗 Tech Stack

• Next.js 16 + React 19 + Tailwind CSS 4 + Framer Motion
• D3-geo projection + custom SVG
• Electron 42 + Next.js standalone
• HMAC-SHA256 auth + rate limiting
• Vitest + V8 Coverage

⚙️ Environment Variables

Variable	Description
SITE_PASSWORD	Site entry password (default: 1234)
ADMIN_PASSWORD	Admin password (default: admin1234)
SUPABASE_URL	Supabase URL (web deployment)
SUPABASE_SERVICE_ROLE_KEY	Supabase key (web deployment)