Decide which Shade layer (Token, Primitive, Component, Recipe, Pattern) a new piece of UI belongs in — and whether it should be added to Shade at all. Trigger when creating new files in apps/shade/src/components, or proposing to add a new Shade component.

2026-06-3054.3k

shade-dropdown-surface-contract

TryGhost/Ghost

DropdownMenu, Select, and Popover share one visual recipe (bg-surface-elevated-2 + border-border/60 dark:border-border/30 + shadow-md). Change them together. Trigger when editing any of those three Shade files.

2026-06-3054.3k

shade-imports

TryGhost/Ghost

Import Shade from layer-specific subpaths (primitives, components, patterns, page-templates, utils), never the root barrel. Trigger when editing TSX/TS in Shade-consuming apps.

2026-06-3054.3k

shade-inputsurface-recipe

TryGhost/Ghost

Use the inputSurface() recipe for form-control chrome (border, background, radius, focus ring, invalid state) — don't roll your own. Trigger when editing form-control-shaped files in Shade.

2026-06-3054.3k

shade-new-component

TryGhost/Ghost

Acceptance checklist for adding or editing a Shade component or pattern file — naming, sibling story, className forwarding, cva variants, required states, recipe usage. Trigger when editing files in apps/shade/src/components.

2026-06-3054.3k

shade-no-dark-variants

TryGhost/Ghost

Don't write dark: Tailwind variants for colour in Shade or admin apps — semantic tokens flip in dark mode automatically. Trigger when editing TSX in Shade-consuming apps.

2026-06-3054.3k

name	Add Admin API Endpoint
description	Add a new endpoint or endpoints to Ghost's Admin API at `ghost/api/admin/**`.

Create Admin API Endpoint

Instructions

If creating an endpoint for an entirely new resource, create a new endpoint file in ghost/core/core/server/api/endpoints/. Otherwise, locate the existing endpoint file in the same directory.
The endpoint file should create a controller object using the JSDoc type from (@tryghost/api-framework).Controller, including at minimum a docName and a single endpoint definition, i.e. browse.
Add routes for each endpoint to ghost/core/core/server/web/api/endpoints/admin/routes.js.
Add basic e2e-api tests for the endpoint in ghost/core/test/e2e-api/admin to ensure the new endpoints function as expected.
Run the tests and iterate until they pass: cd ghost/core && pnpm test:single test/e2e-api/admin/{test-file-name}.

Reference

For a detailed reference on Ghost's API framework and how to create API controllers, see reference.md.