Quick Start

Get the Vulcan development environment running in minutes.

Prerequisites

• Git with SSH access to GitLab
• Docker and Docker Compose
• Node.js 20+ (for frontend)
• .NET 10 SDK (for backend)
• Make (for workspace commands)

Clone the Workspace

# Clone with all submodules
git clone --recursive git@gitlab.hantverksdata.se:vulcan/vulcan-workspace.git
cd vulcan-workspace

# Or if you already cloned without --recursive
git submodule update --init --recursive

Start Development Services

# Start databases and shared services
make dev

This starts:

• 9 PostgreSQL databases (one per capability)
• Redis for caching
• Azurite for Azure Storage emulation

Start the Frontend

# In a new terminal
make dev-web

Visit http://localhost:5173

Start a Backend Capability

# Start the core setup service
make dev-be CAP=coresetup

The API will be available at http://localhost:5000

Available Commands

Command	Description
make dev	Start databases and shared services
make dev-web	Start frontend dev server
make dev-mobile	Start mobile dev server (Expo)
make dev-be CAP=x	Start specific backend capability
make test	Run all tests
make stop	Stop all Docker services
make help	Show all available commands

Database Ports

Each capability has its own PostgreSQL database:

Capability	Port
coresetup	5432
leads	5433
quotation	5434
contracts	5435
projects	5436
invoicing	5437
documents	5438
ai	5439
planning	5440

Next Steps

• Set up your IDE and extensions
• Understand the project architecture
• Read the contribution guidelines