Public documentation
Mira’s public product surface is a Next.js app on Vercel at www.joinmira.ai. The site is open without login, and application data lives in PostgreSQL. A Node/Express intelligence API orchestrates competitor discovery, scrape/research waterfall, feature matrices, market models (TAM/SAM/SOM), and distribution views.
Research providers include You.com (contents / research / finance) and structured extraction via OpenRouter-compatible models. Optional integrations include Zendesk messaging, Resend email, and web push. Machine indexes: /llms.txt, /AGENTS.md, /sitemap.xml, and /.well-known/mcp/server-card.json.
Founded 2025-01-15 by Sam Karri. Support: support@joinmira.ai. This preamble is server-rendered so crawlers receive readable text even if interactive diagrams below require JavaScript.
About · Team · Contact · FAQ · support@joinmira.ai
Architecture
Blueprint of the product stack, website, Express API, PostgreSQL data, and You.com skills that power live competitive intelligence.
View blueprintBlueprint architect
Four lanes from the browser to intelligence providers. Skills on the right map 1:1 to chips you see in the product UI.
Mira · v1 blueprint
Edge → control plane → data → intelligence
Lane 01
Users & delivery
joinmira.ai
Next.js 15 · Vercel
Open site
No login or session gate
Workspace
Analysis · Labs · Market
Lane 02
Express API
REST + jobs
Background market / deep dive
Agents
discover · fetch · digests
Cron
24h refresh · weekly mail
Lane 03
PostgreSQL + JSON
Postgres
Products · competitors · snapshots
Feature requests
Local JSON file
Settings
Workspace data · keys
Lane 04
You.com Research APIs
you-web
Search · Evidence · fact-check
you-research
Reviews · talk tracks · overview
you-finance
TAM · investor · market model
you-contents
Pricing pages · site text
Scroll lanes · left to right on desktop
How a user action becomes a You.com skill call and lands back in the UI with source chips.
Hosting split
Vercel
Next.js frontend · joinmira.ai · public routes
Node host
Express API · long jobs · cron · secrets
Data
PostgreSQL app data · JSON feature requests
The website talks to a persistent Express API. That API owns long jobs and secrets; Browser storage and JSON keep the open workspace lightweight; You.com supplies live research and structure.
joinmira.ai
Next.js App Router UI for marketing pages and the open workspace.
Node · Express
Persistent Node process for discovery, market jobs, cron refresh, and digests.
PostgreSQL
Shared workspaces, settings, reports, jobs, and market intelligence data.
You.com
Live research, source retrieval, and structured analysis from You.com.
Request path
Website
Next.js on Vercel, Discover, Market, Company, Distribution
API base
NEXT_PUBLIC_API_BASE → Express API + shared workspace
Orchestration
Agents & routes: discover → refresh → market intel → digests
Providers
You.com research/contents/finance · optional Tavily
Persistence
PostgreSQL stores products, competitors, snapshots, and jobs
What each layer runs, and why it sits where it does.
You.com is the live research backbone. The website never calls You.com directly - the Express API owns the key, rate-limits requests, and maps results into Mira features.
Client module
server/services/youcom.js
Serializes outbound calls with spacing (YOUCOM_MIN_INTERVAL_MS), retries on 429/5xx, and exposes three operations used across agents and routes.
search
POST /v1/search
Cheap web search for Evidence research and fact-check before finance.
research
POST /v1/research
Competitor discovery, reviews, war-room talk tracks, company overview.
contents
POST /v1/contents
Fetch pricing pages and site text for snapshots and ICP/pricing layers.
finance_research
POST /v1/finance_research
Market sizing, investor enrich, market model, deep-dive financials.
Each flow starts in the Next.js UI and lands in a You.com call on the API.
Market jobs and cron need a process that stays alive, so the Express API is deployed separately from the Vercel frontend.
The repository is vendor-neutral. Start the API with npm start and deploy the client from client/. In production, set NEXT_PUBLIC_API_BASE to the active Express API URL. See the system blueprint for the full lane diagram.
Supporting services around research, messaging, and delivery.
| Service | Role | Where |
|---|---|---|
| PostgreSQL | Workspace and intelligence data | server/db |
| You.com | Live web research and page contents | server/services/youcom.js |
| Resend | Digests and support mail | server/services/email.js |
| Tavily | Market-model fact-check | server/services/tavily.js |
| Zendesk | In-app messaging widget | ZendeskWidget.jsx |
| Web Push | Browser notifications (VAPID) | server/services/push.js |
Discover competitors, build a market model, and watch You.com-backed research land in your workspace.