veza/README.md
2026-02-15 16:13:20 +01:00

1.2 KiB

Veza Monorepo

Project Structure

  • apps/web: The main frontend application (React + Vite). This is the single source of truth for the UI.
  • veza-desktop: A thin Electron wrapper that loads apps/web. It creates the native desktop experience.
  • veza-backend-api: Main Go API service.
  • veza-stream-server: Rust streaming server.
  • veza-chat-server: Rust chat server.

Quick Start

Frontend

cd apps/web
npm install
npm run dev

Desktop (Optional)

Requires apps/web to be running.

cd veza-desktop
npm install
npm run dev

Docker Production

Canonical production compose file: docker-compose.prod.yml

docker compose -f docker-compose.prod.yml up -d

Deprecated (use docker-compose.prod.yml):

  • docker-compose.production.yml — legacy, may be removed
  • config/docker/docker-compose.production.yml — legacy config

See make/config.mk for COMPOSE_PROD and deployment docs.

Documentation

  • Developer Onboarding — Setup, architecture, conventions, troubleshooting
  • See docs/ for detailed architecture and development guides. Older audits and reports are archived in docs/archive/.