The manifest (service.yaml)

service.yaml is the only required file. It registers your service and powers the landing card and console header.

Required fields

• title — display name, e.g. Compute.
• category — grouping label, e.g. Platform.
• order — sort position on the landing page (lower is earlier).
• description — one line shown on the card and console header.
• icon — one of the built-in icons (compute, cube, robot, circles, shield, grid, code, pipeline, chart, database).
• accent — pastel hex for the icon tile, e.g. #d8f3dc.

Optional fields

• status — operational, degraded, or maintenance (defaults to operational).
• owner, slack, email — shown in the console Contact card.
• uiHref — link for the Open UI action (omit or # to show "soon").
• docsHref — usually /services/<slug>/docs.
• notionHref — external Notion space; adds a Notion tab in the console.

Example

title: Compute
category: Platform
order: 1
description: GKE clusters, virtual machines, and GPUs.
icon: compute
accent: "#d8f3dc"
uiHref: "#"
docsHref: /services/compute/docs
status: operational
owner: Platform · Compute
slack: "#platform-compute"
email: platform@abridge.services
notionHref: https://www.notion.so/abridge/Compute-Platform