Commands

Development

pnpm dev              # Start web dev server
pnpm build            # Production build (web)
pnpm type:check       # TypeScript type checking (web)
pnpm emulators        # Start Firebase emulators

Documentation

cd docs
pnpm dev              # Start docs dev server (VitePress)
pnpm build            # Build static docs site
pnpm preview          # Preview built docs

Data Pipeline

# Sniff vector data from a mall's map page
python3 agent/tools/mappedin-sniff/sniff.py <map-page-url> -o <output-dir>/

# Parse and convert sniffed data
PYTHONPATH=agent python3 -c "from parsers.convert import convert; convert('screens/osm/sniff_data/theglen/')"

# Import a new mall
python3 agent/scripts/import_mappedin_mall.py <sniff_dir> "<Mall Name>" "<City>" <country_code>

# Backfill all malls (first run — claims legacy data + deduplicates)
python3 agent/scripts/backfill_mappedin_all.py --first-run

# Backfill all malls (subsequent runs — pure idempotent upsert)
python3 agent/scripts/backfill_mappedin_all.py