Build from source

You need the .NET 10 SDK (see global.json). The repository has one entry point per shell: ./manage.sh (bash) and .\manage.ps1 (PowerShell 5.1 and 7), with the same verbs and options.

git clone https://github.com/Cacsjep/oadm.git
cd oadm
./manage.sh run dev             # build, start the server in the background, then the client
./manage.sh run client --fake   # client with sample data, no server

On the first run dev, confirm the fingerprint, then create the first administrator.

Commands

Command	What it does
manage build [all|server|client|plugins|docs]	Build the solution or a part of it
manage run server	Run the server in the foreground on https://0.0.0.0:5080
manage run client [--fake] [--server URL]	Run the client
manage run dev	Server in the background, then the client; closing the client stops the server
manage test [unit|timing|perf|hardware|all]	Run tests
manage publish [all|server|client] [--rid RID]	Self-contained apps in artifacts/publish/
manage package <windows|linux|macos>	Installer in artifacts/packages/
manage new <task|page|action> --name NAME	A new plugin from a tutorial, under your name, ready to build and run
manage build docs	The SDK reference of this website, for the local docs server
manage clean	Remove bin, obj and artifacts

manage help lists everything; manage <verb> help shows the options of a verb.

Tests

Category	Command	Content
Unit	manage test unit	Fast, no network, no devices
Timing	manage test timing	Depend on real time; local only, not in CI
Perf	manage test perf	5,000 devices, 50,000 tasks
Hardware	manage test hardware	Read-only, against your cameras in dev-cameras.yaml
HardwareWrite	never from manage	Change a device; only on purpose, only on a test device

The UI is tested with Avalonia headless rendering. Set OADM_SCREENSHOT_DIR to keep the screenshots.

Contributing

Read CONTRIBUTING.md and CLAUDE.md, the spec and coding rules. Changes go through a pull request; the Linux tests must pass.