Skip to main content
Documentation

Development setup

This guide covers setting up OpenDDE for local development with hot reloading.

Prerequisites

  • Docker Desktop 4.0+
  • Node.js 18+ (for frontend development)
  • Python 3.11+ (for backend development)
  • Git

Clone and install

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

# Frontend dependencies
cd frontend && npm install && cd ..

# Backend dependencies (optional, for IDE support)
cd backend && pip install -r requirements.txt && cd ..

Running in development mode

# Start all services with hot reload
docker compose up --build

The development docker-compose.yml mounts source directories as volumes, so changes to frontend and backend code are reflected immediately:

  • Frontend: Next.js Fast Refresh (instant updates)
  • Backend: Uvicorn with --reload flag

Standalone frontend development

If you’re only working on the frontend and the backend is already running:

cd frontend
npm run dev

This starts Next.js on port 3000 outside Docker, connecting to the backend at port 8000.

Running tests

# Backend tests
cd backend && pytest

# Frontend (if tests exist)
cd frontend && npm test

Next: Adding new engines →