Apps

An app is a single web application Qassandra is responsible for testing. Everything else — flows, checks, suggestions, screenshots — hangs off an app.

What an app contains

Each app stores:

URL — the entry point Qassandra opens. Use a stable URL that always renders your app. For preview deployments, pass the per-deploy URL when you trigger a check (it overrides the default for that run).
Name — what the app shows up as in your dashboard.
Description — what the app does. The AI uses this both during discovery (to focus on the right flows) and during AI-assisted recovery.
Personas — the kinds of users that visit the app (e.g. “new signups”, “admins managing billing”). Discovery prioritises journeys relevant to these personas.
Agent notes — free-form instructions for the agent. This is where you put login credentials, “always dismiss the cookie banner first”, or “ignore the /dev playground route”.
Main branch — used to identify the baseline check for visual regression. Defaults to main.
Cron expression — optional schedule that triggers checks automatically. See Scheduled checks.
GitHub repo — links the app to a repository so the GitHub App can trigger checks from PRs. See GitHub App.
API key — a single per-app bearer token (qsk_…) for programmatic check triggering. See API authentication.

App understanding

When you first add an app, Qassandra makes a one-shot “app understanding” request: it visits the URL, screenshots the landing state, and asks an LLM to summarise what the app does and who uses it. The result pre-populates your description and personas. You should review and edit them — better context produces better flow discovery.

Multiple environments

Most teams keep one app per environment (e.g. myapp-prod and myapp-staging). This way each environment has its own flows, baseline screenshots, schedule, and API key.

Apps and organizations

Every app belongs to an organization. Members of an org share access to all of its apps, with role-based permissions handled at the org level. See Organizations & teams for details on inviting teammates and switching orgs.

Deleting an app

Deleting an app removes its flows, checks, suggestions, screenshots, and API key. This is irreversible. The danger zone lives at the bottom of App settings.