Skip to content

Onboarding wizard

What it does: 4-step UI an operator clicks through to provision a new agent.

Function presets do most of the policy authoring; categories fill in the rest; compliance packs add regulatory floors. The wizard is the visual surface that strings these together into a 60-second flow. For operators who prefer terminal, the operator-cli does the same thing.

The wizard is real TapPass dashboard work — frontend engineering. But every wizard step has a CLI equivalent; the wizard is glue, not the source of truth.

StepUIEquivalent CLI
1Function picker (11 starter options + Custom)(input to sandbox-spec create)
2Category toggles, pre-ticked from function(input)
3Compliance pack picker (EU AI Act, OWASP LLM, GDPR, …)tappass policy apply --pack <name>
4Preview & commit, with because-trailtappass sandbox-spec emit-bootstrap <name>

React component tree under tappass/dashboard/src/wizard/. Renders the cascade-aware preview using the policy-to-sandbox-config-builder derive(mode=preview) API (no persist, no audit emit).

  • All acceptance_criteria pass.
  • Usability test: 5 non-engineering operators can complete a typical case in <90s on first attempt.
  • Output equivalence test with CLI verified on 100 random configs.

With operator-cli: must produce identical output. Define the equivalence as a property test.

  • Sandbox monitoring / audit views — these live elsewhere in the dashboard.
  • Project / team management — projects-teams-concept.md covers that surface.