# HereNow (ヒアナウ) — Ambient Place Curiosity Companion

> HereNow is an ambient streetscape curiosity companion and 1-card decision engine.
> It decodes the streetscape within a 10-minute walk from the user's current coordinates using multimodal LLM synthesis (Google Gemini 3.8 Flash) with real-time Google Search Grounding.

## Overview & Philosophy
Unlike traditional directory maps (such as Google Maps or Yelp) cluttered with 50+ pins and commercial ad placements, HereNow focuses on immediate micro-decisions:
- Focus Deck: 1 curated place card at a time.
- Three immediate choices: "Take Me There", "Tell Me More (Story)", or "Pass (Next Card)".
- Atmospheric storytelling: Blends artisan third-wave cafes with 100-year-old local lore, wartime remnants, architectural oddities, and live today/tonight events.

## The 10 Curatorial Lenses
1. `ALL` (✦ All Curations): Balanced atmospheric mix of food, lore, oddity, and live happenings. [Grounded]
2. `CAFE_BITES` (☕ Cafes & Bites): Third-wave espresso roasteries, tucked bakeries, tea salons. [Grounded]
3. `EATS_DINING` (🍜 Eats & Dining): Multi-generational ramen dens, izakayas, neighborhood bistros. [Grounded]
4. `DRINKS_NIGHT` (🍸 Drinks & Night): Vinyl listening bars, craft beer cellars, speakeasies. [Grounded]
5. `SHOPS_INDIE` (🛍️ Shops & Indie): Indie bookshops, vintage clothing, specialty craft & vinyl. [Grounded]
6. `HISTORY_LORE` (📜 Lore & History): Edo/Meiji milestones, forgotten poets' salons, wartime markers. [Pure AI Lore]
7. `URBAN_ODDITY` (🔍 Urban Oddities): Architectural quirks, preserved facades, retro artifacts. [Pure AI Lore]
8. `EVENT_HAPPENING` (🎭 Events & Buzz): Flea markets, live gigs, art popups, neighborhood matsuri. [Grounded]
9. `MICRO_QUEST` (🧭 Micro-Quests): 10-minute observational strolls, hidden staircases, alleys. [Pure AI Lore]
10. `SANCTUARY` (🍃 Sanctuaries): Pocket gardens, secluded temple precincts, tranquil benches. [Pure AI Lore]

## Technical Architecture & APIs
- **Frontend**: Mobile-First PWA (React 19, TypeScript, Tailwind CSS, Vite) with 60fps touch drag physics, view transitions, and offline service worker caching.
- **Edge Layer**: Centralized serverless proxy on Cloudflare Workers (Tokyo NRT) handling anonymous installation tokens, spatial caching (~200m Haversine cells with 30m TTL), and rate limiting.
- **Discovery Endpoint**: `POST https://herenow-proxy.hoangnda.workers.dev/api/v1/discover`
- **AI Core**: Google Gemini 3.8 Flash with Google Search Grounding for live hours, dates, and verification.
- **Modes**:
  - Managed Mode: 10 free daily discoveries out of the box with zero user configuration.
  - BYOK Mode: Personal Google Gemini API key entered in settings for unlimited queries.

## Navigation & Integrations
- 1-tap navigation directly routes to Google Maps using formatted queries: `mapsSearchQuery: "$VenueName, $StreetName, $Neighborhood, $City"`.
- Bilingual support: Full English and Japanese (日本語) translation across all lenses and prompts.