Developer Overview

Vezta is a prediction market trading terminal that aggregates markets from Polymarket and Kalshi into a unified trading interface. The codebase is a monorepo containing three independent subprojects that share a single backend API.

Monorepo Structure

All subprojects use pnpm as the package manager.

Data Flow

Polymarket API ──┐
                 ├──▶ vezta-be Ingester ──▶ PostgreSQL
Kalshi API ──────┘         │
                           ├── REST API (/api/v1)
                           └── WebSocket (/ws)
                                  │
                           ┌──────┴──────┐
                           ▼             ▼
                       vezta-fe     vezta-mobile
                      (Next.js)      (Expo)

The backend continuously ingests market data from Polymarket and Kalshi, normalizes it into a unified schema, stores it in PostgreSQL, and serves it to clients via REST and WebSocket APIs. Redis handles caching, pub/sub for real-time delivery, and BullMQ job queues for background processing.

API Contract

The backend auto-exports an openapi.json specification on startup. The frontend uses Kubb to generate TypeScript types, Zod schemas, fetch clients, and TanStack Query hooks from this spec. After any backend API change, run pnpm generate in vezta-fe/ to regenerate the client layer. The mobile app's lib/api/gen/ directory is a manual copy of the frontend's generated code.

Shared Patterns

The frontend and mobile app share several code layers that are kept in sync manually:

• lib/api/gen/ -- auto-generated API layer (types, hooks, schemas)
• lib/utils.ts, lib/constants.ts, lib/types/ -- shared utilities and TypeScript interfaces
• lib/ws/ -- WebSocket client with Jotai atoms for real-time state
• lib/trading/ -- PnL helpers and price impact calculations

Sections