The world is your watchlist.
What it does. See a brand. Get the ticker. Mapvest is four layers on one loop:
- (A) Identify anything around you via camera or map — a public brand returns its ticker; a private one resolves to the closest public cousin plus an ETF with real exposure. Sources, always.
- (B) Agentic research on the company you found — or the local economy around it.
- (C) Finance agent briefs, memos, and saved chats on the names you care about.
- (D) Analytics to think about positions — charts and modules for how and why to own or trade a name.
Every identify is kept as a find — your universe of companies you've seen with your own eyes, growing as you move through the world.
mapvest/
├── AGENTS.md # rules for AI agents working in this repo
├── IMPLEMENTATION_PLAN.md # phased build plan
├── docs/ # architecture, data sources, deploy, secrets
├── apps/
│ ├── api/ # Bun + Hono backend (public API)
│ ├── ios/ # Expo React Native iOS app
│ └── landing/ # web landing page (Next.js)
├── packages/
│ ├── core/ # shared TS types + zod schemas
│ ├── vision/ # OpenRouter multimodal wrapper (image → brand/product)
│ ├── finance/ # ticker resolution + private→public comparable + ETF match
│ └── search/ # Exa search wrapper
└── infra/ # Railway + Doppler config
# 1. Doppler: personal workplace, project mapvest
doppler setup --project mapvest --config dev
# 2. Install
bun install
# 3. Dev
bun run dev # runs api, landing, and expo start- Landing: https://mapvest.app (
wwwon Railway; apex301s towww) - API: https://api-production-4b27.up.railway.app (see
docs/DEPLOY.md) - iOS: TestFlight via EAS (see
apps/ios/README.md)
AGENTS.md— rules for AI contributorsIMPLEMENTATION_PLAN.md— the build plandocs/ARCHITECTURE.mddocs/DATA_SOURCES.mddocs/SECRETS.mddocs/DEPLOY.mddocs/SYSTEM_DESIGN.mddocs/SHARE_AND_WIDGETS.md— share-to-Mapvest + home-screen widgets
MIT