Skip to content

docs: Astro 6 + Starlight IDP site with auto-derived catalog#8

Merged
danielmeppiel merged 1 commit intomainfrom
docs/idp-site
May 7, 2026
Merged

docs: Astro 6 + Starlight IDP site with auto-derived catalog#8
danielmeppiel merged 1 commit intomainfrom
docs/idp-site

Conversation

@danielmeppiel
Copy link
Copy Markdown
Contributor

Builds a GitHub Pages site under docs/ (Astro 6 + Starlight) that surfaces the marketplace as an Internal Developer Portal organised by SDLC phase.

What's in it

  • Auto-derived catalog — pages are generated at build time from .claude-plugin/marketplace.json + per-plugin apm.yml / plugin.json keywords / .apm/ contents. Add a plugin to the marketplace with the right keyword and it shows up; no hand edits needed.
  • Three install flows per pluginapm.yml pin (pinned to #v6.1.0), one-shot CLI, and marketplace registration.
  • Global policy surfaced everywhere — a PolicyBanner on landing, quick-start, catalog, every plugin page, and a dedicated Governance → Policy & CI page deep-link to DevExpGbb/.github/apm-policy.yml and the upstream APM CI policy setup guide.
  • Deploy workflow.github/workflows/deploy-pages.yml rebuilds and publishes to GitHub Pages on any change to docs/**, plugins/**, .claude-plugin/**, or apm.yml, so the catalog stays in sync as the marketplace evolves.

Local dev

cd docs
npm install
npm run dev    # http://localhost:4321/zava-agent-config/
npm run build  # 25 pages → docs/dist

Site URL once Pages is enabled: https://devexpgbb.github.io/zava-agent-config/.

Follow-ups (post-merge)

  • Enable GitHub Pages with Source: GitHub Actions in repo Settings → Pages (one-time).

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

Builds a GitHub Pages site under docs/ that surfaces the marketplace as an
Internal Developer Portal organised by SDLC phase. Catalog is derived at
build time from .claude-plugin/marketplace.json + per-plugin apm.yml /
plugin.json / .apm/ contents, so the site updates automatically as the
marketplace and vendored plugins change.

Each plugin page ships three install flows (apm.yml pin pinned to v6.1.0,
one-shot CLI, marketplace registration). The global apm-policy.yml is
surfaced on every page via a banner that deep-links to
DevExpGbb/.github/apm-policy.yml and the upstream APM CI policy setup guide.

A deploy-pages workflow rebuilds and publishes on any change to docs/**,
plugins/**, .claude-plugin/**, or apm.yml.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@danielmeppiel danielmeppiel merged commit 3433542 into main May 7, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant