Builder

Builder

Compile applications before testing or deployment.

Reference Documentation

When to Build

Build is required when:

• Source code has changed
• Dependencies have been updated
• First time setting up the project
• After pulling new changes from git

Workflow

STEP 1: IDENTIFY APP

Determine which app needs building:

STEP 2: CHECK PREREQUISITES

Before building, verify:

• Required tools are installed
• Environment is configured
• Dependencies are available

See app-specific reference for prerequisites.

STEP 3: CONFIGURE (if needed)

Run configuration step on:

• First build
• After changing build configuration
• After updating dependencies

STEP 4: BUILD

Execute build command. Handle common issues:

• Kill running processes (file locks)
• Clean build if needed
• Check for errors

STEP 5: VERIFY

Confirm build succeeded:

• Check for executable/output
• Run basic health check
• Note any warnings

Quick Reference

Desktop App

cd D:\projects\buddy\desktop

# First time or after config changes
.\configure.ps1

# Build (kills running process automatically)
.\build.ps1

# Verify
.\build\Debug\BuddyDesktop.exe --version

Backend (no build needed)

cd backend
uv sync                          # Install/update dependencies
uv run uvicorn backend.main:app  # Run directly

Build Errors

Common Issues

When to Clean Build

# Desktop - remove build directory
Remove-Item -Recurse -Force desktop/build
.\configure.ps1
.\build.ps1

Clean build when:

• Switching branches with major changes
• Updating build configuration
• Unexplained linker errors
• Dependency version conflicts

Integration with Testing

Always build before running tests:

# Desktop workflow
.\desktop\build.ps1                             # Build first
.\desktop\build\Debug\BuddyDesktop.exe --debug  # Run in debug mode
python desktop/tests/T00022/T00022-01.py        # Then test

Critical Rules

1. Build before test - Always compile latest code
2. Check for errors - Don't ignore warnings
3. Kill running processes - Prevents file lock issues
4. Clean when stuck - Fresh build solves many issues
5. Document build issues - In 5-progress-and-issues.md