"""Branded landing page for the Matrix Builder control-plane API.
Served at ``/`` so the Hugging Face Space (and any direct backend host) shows a
real page — the API's "front face" — rather than a bare JSON. The full
interactive UI lives on Vercel (``build.matrixhub.io``); this page links to it
and to the sibling services that make the ecosystem work end to end.
"""
from __future__ import annotations
# Scout design system palette (matrix-definitions / matrix-builder web).
_BG = "#02170f"
_GREEN = "#22c878"
_MINT = "#53f39d"
_LINKS = (
("Open the app", "https://build.matrixhub.io", "The full Matrix Builder UI (Vercel)"),
("API docs", "/docs", "Interactive OpenAPI reference for this service"),
("Readiness", "/api/v1/ready", "Adapter + standards status JSON"),
("agent-generator", "https://ruslanmv-agent-generator.hf.space", "The deterministic generation engine"),
("GitPilot", "https://ruslanmv-gitpilot.hf.space", "A Matrix-native AI coder"),
("The standard", "https://www.matrixhub.io/definitions", "Signed Matrix Definitions"),
)
def landing_html(version: str) -> str:
cards = "\n".join(
f'{title}'
f'{desc}'
for title, href, desc in _LINKS
)
return f"""
Matrix Builder — control plane
control plane · live · v{version}
Give AI coders a
contract, not a prompt.
This is the Matrix Builder API — the control plane that turns
one sentence into a signed, validated Matrix Bundle any AI coder can build
inside. The full interactive experience runs at build.matrixhub.io.
Idea → 3 candidates → Matrix Bundle → your AI coder builds under
contract → validated.
{cards}
"""