Dashboard

Overview of the SpecVault web dashboard — the main interface for managing services, viewing version history, and monitoring breaking changes.

Services list

The main dashboard page shows all registered services as a card grid. Each card displays the service name, team, most recent publish date, current version number, and a badge showing whether the latest version had breaking changes.

From the services list you can:

• Click any service to open its detail page
• Click New Service to register a new API
• Use the search bar to filter services by name or team

Service detail page

The service detail page is the primary workspace for each API. It has three tabs:

Versions tab

Shows the full version history in reverse chronological order. Each row includes the version number, publish date, endpoint count, breaking change count, and the publisher. Click any version to open the diff detail view.

Subscribers tab

Lists all email addresses subscribed to this service. Use the Add Subscriber button to add new addresses. The remove button (trash icon) on each row removes that subscriber immediately.

Settings tab

Edit the service name, team, and base URL. Also shows the service's unique ID (used in API calls) and provides a Delete Service button (requires confirmation).

Version detail / diff view

Clicking a version number opens the diff detail page. This page shows:

• Publish metadata (date, publisher, endpoint count)
• Diff summary: endpoints added, removed, and modified
• Breaking changes list — each with method, path, and description
• Whether subscriber alerts were sent (and how many recipients)
• The raw spec content in a collapsible viewer

Navigation

The top navigation bar provides access to:

• Services — the main service list
• API Tokens — create and manage machine tokens for CI/CD
• Audit Log — full activity history
• Settings — instance configuration (admin only)

Access levels

In the current release, SpecVault has two access levels:

• Admin — full access to all features: create/edit/delete services, manage subscribers, create/revoke tokens, view audit log
• Read-only (planned) — view services and version history, no write access