Quick Start Launch Checklist¶
Purpose¶
Provide a condensed set of commands and expectations for operators who need to bring ShadowHound online quickly using the orchestrated start scripts.
Prerequisites¶
- Repository cloned and opened inside the development container environment.
- Environment configured according to Environment Configuration Guide.
- Familiarity with the helper scripts documented in Script Catalog.
Steps¶
- Run the dependency check to confirm the workstation is ready.
- Launch the orchestrator in the mode that matches your mission (development or production).
- Follow the on-screen prompts and confirm the validation checklist before commanding the robot.
One-Command Launch¶
./start.sh --dev # Development mode (mock robot by default)
./start.sh --prod # Production mode (real robot)
./start.sh # Interactive prompts for new operators
What the Orchestrator Does¶
- Runs environment and dependency diagnostics.
- Creates or updates
.envbased on selected mode. - Builds the workspace if required.
- Validates network connectivity to the robot.
- Launches ROS nodes and the web dashboard.
Common Usage Patterns¶
- Daily development:
./scripts/quick-start-dev.sh - Production field run:
./scripts/quick-start-prod.sh - Web UI smoke test:
./scripts/test-web-only.sh - Pre-flight verification:
./scripts/check-deps.sh
Validation¶
- [x] Launch completed without errors using the chosen mode.
- [x] Web dashboard accessible (or intentionally disabled) and responsive.
- [x] Mission commands accepted (mock confirmations or hardware motion observed).
- [x] Scripts verified to exist and match documented usage patterns.
See Also¶
- Project Overview Hub - Planning and operations
- Quick Reference - Command cheat sheet
- Startup Validation - Health checks
- Robot Testing - Hardware validation
- Environment Variables - Configuration reference