Public documentation

Mira architecture

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

How Mira is built

Blueprint of the product stack, website, Express API, PostgreSQL data, and You.com skills that power live competitive intelligence.

View blueprint

Blueprint architect

System blueprint

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

Edge

Users & delivery

  • joinmira.ai

    Next.js 15 · Vercel

  • Open site

    No login or session gate

  • Workspace

    Analysis · Labs · Market

Lane 02

Control plane

Express API

  • REST + jobs

    Background market / deep dive

  • Agents

    discover · fetch · digests

  • Cron

    24h refresh · weekly mail

Lane 03

Data plane

PostgreSQL + JSON

  • Postgres

    Products · competitors · snapshots

  • Feature requests

    Local JSON file

  • Settings

    Workspace data · keys

Lane 04

Intelligence

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

Request blueprints

How a user action becomes a You.com skill call and lands back in the UI with source chips.

Analysis report

  1. 1UI /app
  2. 2API layers
  3. 3You.com research
  4. 4Structured report
  5. 5Persist analysis-latest

Market model

  1. 1UI /market
  2. 2Persistent API job
  3. 3you-finance
  4. 4Optional Tavily check
  5. 5TAM → SAM → SOM

Evidence locker

  1. 1UI Labs
  2. 2You.com search
  3. 3You.com candidates
  4. 4Save locally

Deep dive

  1. 1UI /company
  2. 2Parallel sections
  3. 3you-research + you-finance
  4. 4Dossier + sources

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

System design

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

Browser

Next.js App Router UI for marketing pages and the open workspace.

Node · Express

API

Persistent Node process for discovery, market jobs, cron refresh, and digests.

PostgreSQL

Data

Shared workspaces, settings, reports, jobs, and market intelligence data.

You.com

Intelligence

Live research, source retrieval, and structured analysis from You.com.

Request path

1

Website

Next.js on Vercel, Discover, Market, Company, Distribution

2

API base

NEXT_PUBLIC_API_BASE → Express API + shared workspace

3

Orchestration

Agents & routes: discover → refresh → market intel → digests

4

Providers

You.com research/contents/finance · optional Tavily

5

Persistence

PostgreSQL stores products, competitors, snapshots, and jobs

Tech stack

What each layer runs, and why it sits where it does.

Frontend

  • Next.js 15 · App Router and server-rendered pages
  • React 18 · Client components for workspace UIs
  • Tailwind CSS 3.4 · Design system tokens (ink + accent)
  • Framer Motion / Recharts · Landing motion and in-app charts

API

  • Express · REST orchestration and long-running jobs
  • node-cron · 24h competitor refresh + weekly digests
  • pg · Server-side PostgreSQL access

AI & research

  • You.com API · research, contents, finance_research
  • Tavily (optional) · Independent fact-check for market models

Platform

  • PostgreSQL · Workspace and intelligence data
  • JSON store · Dependency-free public feature requests
  • Vercel · Preferred frontend host for joinmira.ai
  • Resend / Zendesk · Transactional email and in-app support

How we use You.com

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.

Wired into the product

Each flow starts in the Next.js UI and lands in a You.com call on the API.

Discover competitors

  1. 1.UI calls /api/discover
  2. 2.API sends product context to research
  3. 3.You.com finds the rival set
  4. 4.Candidates are normalized for approval

Refresh snapshots

  1. 1.Cron or manual refresh
  2. 2.fetchAgent pulls pages via contents
  3. 3.Diff detects pricing / messaging changes
  4. 4.Workspace surfaces alerts

Market model

  1. 1.Market intelligence job starts
  2. 2.finance_research sizes the market
  3. 3.You.com builds the TAM→SOM narrative
  4. 4.Optional Tavily fact-check

Company deep dive

  1. 1.Company routes request overview
  2. 2.research + finance_research enrich
  3. 3.Reviews and financials land in UI
  4. 4.Distribution uses share / traffic signals
Call sites include discoveryAgent, fetchAgent, routes/intelligence, routes/company, and syndicatedShare. You.com Research returns the structured JSON used by the UI, with source links preserved for verification.

Frontend, API, and data hosting

Market jobs and cron need a process that stays alive, so the Express API is deployed separately from the Vercel frontend.

Node API host

API required
  • •cia-api, Express server with health check at /api/health
  • •Holds You.com, Resend, and cron secrets
  • •Needed for 2–3 minute market jobs and scheduled refresh
  • •Deployable to any persistent Node.js environment

Vercel

Frontend
  • •Hosts the Next.js client (root directory: client)
  • •Serves joinmira.ai / www.joinmira.ai
  • •Runs server-rendered pages and feature-request APIs
  • •NEXT_PUBLIC_API_BASE points at the active API URL

PostgreSQL

Data plane
  • •Persistent workspace and intelligence data
  • •Used by the Express API through the pg client
  • •Shared workspace selection without user sessions

Deploy config

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.

Other integrations

Supporting services around research, messaging, and delivery.

ServiceRole
PostgreSQLWorkspace and intelligence data
You.comLive web research and page contents
ResendDigests and support mail
TavilyMarket-model fact-check
ZendeskIn-app messaging widget
Web PushBrowser notifications (VAPID)

See it in the product

Discover competitors, build a market model, and watch You.com-backed research land in your workspace.