RackPeek/docs/development/dev-setup.md

Developer Setup

RackPeek requires the .NET 10 SDK. Docker is required for web UI end-to-end tests. The mobile app also requires Flutter; build iOS apps on macOS with Xcode.

Install tools

• Install .NET 10 for your operating system.
• Install Docker Desktop or Docker Engine. Start the daemon before building images or running E2E tests.
• Install just to use the repository's build and test recipes.
• For mobile work, install Flutter and the platform tools for your target device.

The repository includes a devcontainer with the .NET and Docker development tools configured.

Check the setup

From the repository root:

dotnet --version
docker info
just --list
just build

Run the fast test projects with just test-cli, just test-discovery, and just test-mcp. Run browser tests with just test-e2e; the first run also needs Playwright's browser install:

just e2e-setup

Repeat just e2e-setup after upgrading Microsoft.Playwright so the installed browser matches its pinned version.

Mobile app

From mobile/:

flutter pub get
flutter run
flutter test
flutter analyze

Use Xcode for iOS signing and device builds. See the mobile README for store build commands.