Local Setup

Local Setup

This guide will help you set up a local development environment for TradeX.

Prerequisites

• Bun >= 1.3
• Node.js >= 18
• Docker and Docker Compose (for infrastructure)
• MongoDB (or use Docker)
• PostgreSQL (or use Docker)
• Redis (or use Docker)
• Kafka (or use Docker)

Quick Start

1. Clone the Repository

git clone https://github.com/your-org/tradex.git
cd tradex

2. Install Dependencies

bun install

3. Start Infrastructure

docker-compose -f infra/docker-compose.dev.yml up -d

This starts:

• MongoDB
• PostgreSQL
• Redis
• Kafka
• Zookeeper

4. Configure Environment Variables

Copy example environment files:

cp apps/marketdata-service/.env.example apps/marketdata-service/.env
cp apps/order-service/.env.example apps/order-service/.env
# ... repeat for other services

5. Run Services

Start services in development mode:

# From root directory
bun run dev

# Or individually
cd apps/marketdata-service && bun run dev
cd apps/order-service && bun run dev

Service URLs

Once running, services are available at:

• Market Data Service: http://localhost:3002
• Order Service: http://localhost:3003
• Auth Service: http://localhost:3004
• User Service: http://localhost:3005
• Wallet Service: http://localhost:3006
• Metadata Service: http://localhost:3007
• Frontend: http://localhost:3000
• Docs Service: http://localhost:4321

Database Setup

MongoDB

# Connect to MongoDB
mongosh mongodb://localhost:27017

# Create database
use tradex

PostgreSQL

# Connect to PostgreSQL
psql -h localhost -U postgres

# Create database
CREATE DATABASE tradex;

Next Steps

• Read the Production Deployment guide
• Explore the Architecture
• Check out the API Documentation