# Branchmark

> Multi-app MDX product hub: public What's New / features pages, GitLab PKCE admin, and read-only MCP.

Hub HTML URLs below match the public site (and Cmd+K). MCP and `/md/...` use collection paths like `/demo/pages/overview` — those are not hub HTML routes.

## Demo

Sample product hub for the Branchmark template

### Sections

- [Overview](/demo/overview): What this Branchmark demo hub is for.
- [Blog](/demo/blog): Guides and editorial updates for the demo product hub.
- [Features](/demo/features): Core product capabilities highlighted in the demo hub.
- [Release Notes](/demo/release-notes): Curated shipped highlights for the demo app. These entries power the What's New JSON feed.
- [Changelog](/demo/change-log): Finer-grained product changes for the demo app. Curated highlights live under Release Notes and feed What's New.

### Blog

- [Getting started with Branchmark](/demo/blog/getting-started): How to run the demo hub, edit MDX content, and publish updates.

### Timeline

- [Static GitLab PKCE admin](/demo/change-log#changelog-june-28-2026-static-gitlab-pkce-admin): Editors sign in with GitLab PKCE at /admin, stage MDX on path-named branches, and open merge requests for draft → review → ready.
- [Welcome to the Branchmark demo](/demo/release-notes#release-note-june-25-2026-welcome-to-the-branchmark-demo): Sample release note showing how What's New and release feeds are built from timeline MDX.
- [Docs search and MCP endpoint](/demo/features#feature-june-20-2026-docs-search-and-mcp-endpoint): Agents and editors can list and fetch hub pages through the built-in MCP tools.
- [Docs search and MCP endpoint](/demo/release-notes#release-note-june-20-2026-docs-search-and-mcp-endpoint): Agents and editors can list and fetch hub pages through the built-in MCP tools.
- [Docs search and MCP endpoint](/demo/change-log#changelog-june-20-2026-docs-search-and-mcp-endpoint): Agents and editors can list and fetch hub pages through the built-in MCP tools.
- [Multi-app public hubs](/demo/features#feature-june-15-2026-multi-app-public-hubs): Register additional apps in content/public/_apps.yml to ship multiple product hubs from one codebase.
- [Multi-app public hubs](/demo/change-log#changelog-june-15-2026-multi-app-public-hubs): Register additional apps in content/public/_apps.yml to ship multiple product hubs from one codebase.

### Pages

- [Product Overview](/demo/overview): What this Branchmark demo hub is for.

## Northstar

Second sample app — proves multi-app switching in one repo

### Sections

- [Overview](/northstar/overview): What the Northstar sample hub is for.
- [Blog](/northstar/blog): Short editorial posts for the Northstar sample app.
- [Release Notes](/northstar/release-notes): Curated highlights for Northstar. These entries power What's New.
- [Changelog](/northstar/change-log): Finer-grained changes for the Northstar sample app.

### Blog

- [Switching apps in Branchmark](/northstar/blog/switching-apps): How the Northstar sample proves multi-app hubs in one repository.

### Timeline

- [Introducing the Northstar sample](/northstar/release-notes#release-note-july-10-2026-introducing-the-northstar-sample): Minimal release note so Northstar appears in What's New and the multi-app proof path.
- [Introducing the Northstar sample](/northstar/change-log#changelog-july-10-2026-introducing-the-northstar-sample): Minimal release note so Northstar appears in What's New and the multi-app proof path.
- [App registry checklist](/northstar/change-log#changelog-july-8-2026-app-registry-checklist): Checklist entry tagged for the Northstar changelog only.

### Pages

- [Northstar Overview](/northstar/overview): A second sample product hub for proving Branchmark multi-app switching.

## Template docs

Repo MDX (not public hub routes):

- Editorial Workflow (`content/docs/editorial-workflow.mdx`): Draft, review, and publish documentation changes through Branchmark.
- Getting Started (`content/docs/getting-started.mdx`): Configure the public hub and GitLab PKCE admin, then start editing Branchmark content.

## Agent discovery

- [llms.txt](/llms.txt): this index
- [llms-full.txt](/llms-full.txt): full markdown dump of MCP-indexed pages
- [agent-readability.json](/agent-readability.json): machine manifest of agent surfaces
- MCP streamable HTTP: `POST /mcp` (tools: search_docs, get_page, list_pages, get_navigation)
- [MCP discovery](/.well-known/mcp.json)

## What's New feeds

- [Demo What's New JSON](/demo/whats-new.json)
- [Demo What's New RSS](/demo/whats-new.xml)
- [Northstar What's New JSON](/northstar/whats-new.json)
- [Northstar What's New RSS](/northstar/whats-new.xml)

## Product embed

- [Embed demo](/embed): inline What’s New list via `/embed/branchmark-whats-new.js` (Shadow DOM; fetches `/{app}/whats-new.json`)

## Raw markdown mirrors

Fetch MCP collection markdown via `GET /md/<app>/<collection>/<slug>` (example: `/md/demo/pages/overview`). Keys match `generated/mcp-data.json` routes, not hub HTML paths.