Development Setup

Prerequisites

• Node.js 22+ (see ui/.nvmrc)
• npm

Getting Started

git clone https://github.com/opentrace/opentrace.git
cd opentrace
make install

Commands

make install          # Install dependencies
make ui               # Start dev server (localhost:5173)
make build            # Production build
make test             # Run tests
make fmt              # Format code
make lint             # Lint
make proto            # Generate protobuf types
make ui-build-static  # Static build (no API server dependency)

Running Tests

cd ui
npm test              # Run all tests
npm run lint          # ESLint + Prettier check

Repository Structure

ui/                   — React/TypeScript frontend (graph explorer + browser indexer)
proto/                — Protobuf definitions (shared API contracts)
claude-code-plugin/   — Claude Code plugin (MCP server config)