Public documentation
Mira’s public product surface is a Next.js app on Vercel at www.joinmira.ai. Authentication and PostgreSQL are provided by InsForge. The intelligence API runs on Render (Node/Express) and 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, Render API, InsForge 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
Auth UI
Login · OAuth · sessions
Workspace
Analysis · Labs · Market
Lane 02
Render Express API
REST + jobs
Background market / deep dive
Agents
discover · fetch · digests
Cron
24h refresh · weekly mail
Lane 03
InsForge
Postgres
Products · competitors · snapshots
Auth
Email · Google · GitHub
Settings
Workspace JSON · keys
Lane 04
You.com skills + Grok
you-web
Search · Evidence · fact-check
you-research
Reviews · talk tracks · overview
you-finance
TAM · investor · market model
you-contents
Pricing pages · site text
xAI Grok
Structure JSON for the UI
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 · OAuth routes
Render
cia-api Express · long jobs · cron · secrets
InsForge
Auth + Postgres + storage · always remote
The website talks to a persistent Express API. That API owns long jobs and secrets; InsForge holds data and identity; You.com and Grok supply live research and structure.
joinmira.ai
Next.js App Router UI: marketing, auth, and the signed-in workspace.
Render · Express
Persistent Node process for discovery, market jobs, cron refresh, and digests.
InsForge
PostgreSQL, email/password + OAuth, workspace settings, and storage.
You.com · xAI Grok
Live research and page contents from You.com; structured analysis via Grok.
Request path
Website
Next.js on Vercel, Discover, Market, Company, Distribution
API base
NEXT_PUBLIC_API_BASE → Render Express (Bearer + workspace)
Orchestration
Agents & routes: discover → refresh → market intel → digests
Providers
You.com research/contents/finance · xAI Grok · optional Tavily
Persistence
InsForge Postgres stores products, competitors, snapshots, 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 Render 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. That is why the API lives on Render even when the website is on Vercel.
render.yaml defines cia-api (repo root, npm start) and optional cia-web (client build + next start). Production frontend typically uses Vercel with NEXT_PUBLIC_API_BASE set to the live Render API URL (for example *.onrender.com). See the system blueprint for the full lane diagram.
Supporting services around research, messaging, and delivery.
| Service | Role | Where |
|---|---|---|
| InsForge | Auth, PostgreSQL, storage | server/db · client auth routes |
| You.com | Live web research and page contents | server/services/youcom.js |
| xAI Grok | Structured AI analysis | server/services/ai.js |
| Resend | Digests, invites, 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.