Skip to content

Screenshots

Screenshots

This folder holds the pictures embedded in the rest of the documentation. They are assets referenced by other pages, not standalone reading — start from the documentation index.

Where they come from

Every picture here is taken from the running app by tests/Browser/DocsScreenshotsTest.php, over the demo world database/seeders/DemoEnvironmentSeeder.php builds: the workspace Lovelace Labs (owner Ada Lovelace), its project Ledger and environment of the same name, four apps, the customer organizations Acme Corp (Enterprise SSO and a verified domain), Globex (Directory Sync) and Initech, agents with approvals waiting, audit events, a webhook and a log stream. Light theme, 1440×900, viewport only.

They are retaken on every release. The Docs screenshots workflow (.github/workflows/docs-screenshots.yml) runs on each release tag, and on demand from the Actions tab. It builds the app in the same Linux image and Chromium CI uses, takes every picture below, and opens a pull request against main with the ones that changed; it never pushes to main. Review the image diff in that PR before merging.

The run is also a smoke test of every page pictured: it fails, and proposes nothing, if a page answers an error status, loads anything that fails, shows an error page, or the browser reports an uncaught exception, a console error or warning, or a broken image.

To retake them locally:

npm run build
vendor/bin/pest --group=docs-screenshots

The run overwrites the files below in place. The group is excluded from every normal test run (phpunit.xml and CI both exclude it). Pictures taken on macOS render text slightly differently from the workflow's, so prefer the workflow's PR for anything you commit.

The list is fixed. tests/Support/DocsScreenshots.php names every picture, and the normal test suite holds this folder to it: each file is taken by the generator, embedded by at least one page and listed below, and every picture a page embeds exists. To add one, add its name there, take it in tests/Browser/DocsScreenshotsTest.php, embed it in the page it illustrates, and add its row here.

File Page
hosted-sign-in.png An environment's hosted sign-in page (/login on its host)
workspace-sign-up.png Workspace sign-up on the account host (/signup)
workspace-projects.png Workspace › Projects (/projects, account host)
environment-overview.png Environment console › Home › Overview (/admin)
get-started.png Home › Get started (/admin/get-started)
context-switcher.png The topbar's environment switcher, open
mobile-overview.png The overview at phone width (375×812)
users.png Users & orgs › Users (/admin/users)
organizations.png Users & orgs › Organizations (/admin/organizations)
organization-overview.png An organization's hub, Overview tab
organization-members.png An organization's Members tab
organization-enterprise-sso.png An organization's SSO tab (SAML connection + verified domain)
organization-domains.png An organization's Domains tab
organization-directory-sync.png An organization's Directory Sync tab
directory-detail.png A SCIM directory's page (/admin/sync-in/{id})
roles.png Authorization › Roles (/admin/roles)
applications.png Developers › Applications (/admin/apps)
application-detail.png An application's Overview (/admin/apps/{id})
api-keys.png Developers › API keys (/admin/keys/frontend)
webhooks.png Developers › Webhooks (/admin/webhooks)
agents.png AI agents › Agents (/admin/agents)
approvals.png AI agents › Approvals (/admin/approvals)
audit-log.png Monitoring › Audit log (/admin/audit)
app-audit-logs.png Monitoring › App audit logs (/admin/audit-logs)
log-streams.png Monitoring › Log streams (/admin/log-streaming)
environment-settings.png Settings (/admin/settings)
admin-portal-link.png An Admin Portal link, as the customer's IT admin opens it (/setup/{token})
admin-portal.png The Admin Portal's task list after Open setup