Developer Overview
Monorepo structure, tech stack, and architecture diagram
Vezta is a monorepo with three independent subprojects:
| Subproject | Stack | Port | Description |
|---|---|---|---|
vezta-fe/ | Next.js 16, React 19, Tailwind v4, TanStack Query v5 | 3000 | Web frontend |
vezta-be/ | NestJS, Fastify, Prisma, PostgreSQL, Redis, BullMQ | 3001 | Backend API |
vezta-mobile/ | Expo SDK 55, React Native, NativeWind v4, Reanimated v4 | -- | Mobile app |
Data Flow
Polymarket/Kalshi APIs → Backend Ingester → PostgreSQL → REST API + WebSocket
↓
Web App (Next.js) + Mobile App (Expo)Key Concepts
- API Contract: Backend auto-exports
openapi.json. Frontend uses Kubb to generate TypeScript types, Zod schemas, and TanStack Query hooks from this spec. - Real-Time: Socket.IO at
/wsnamespace with 8 channels for prices, orderbook, trades, orders, notifications, signals, portfolio, and copy-trade updates. - Auth: Wallet-based authentication (Solana + EVM) with JWT access tokens (15min) and httpOnly refresh cookies (7 days).
Quick Links
- Quickstart — Get the dev environment running in 5 minutes
- Tech Stack — Detailed breakdown of all technologies
- Architecture — System design, data model, and pipelines
- API Reference — REST endpoints auto-generated from OpenAPI
- WebSocket Reference — All 8 real-time channels documented