Skip to content

Comments

feat(docs): add comprehensive documentation site#98

Open
vrknetha wants to merge 46 commits intodevelopfrom
feature/docs-site
Open

feat(docs): add comprehensive documentation site#98
vrknetha wants to merge 46 commits intodevelopfrom
feature/docs-site

Conversation

@vrknetha
Copy link
Owner

Summary

  • Adds full Astro Starlight documentation site under apps/landing/ with 20 MDX pages covering CLI, Registry API, Proxy API, Protocol, SDK, guides, architecture, and getting started
  • Fixes all documentation gaps identified in codebase audit: incorrect PoP canonical format, wrong CLI signatures, missing API schemas/error codes, missing connector architecture, and more
  • Adds GitHub Actions workflows for Cloudflare Pages deployment (develop preview + production)

Pages added/updated

  • API Reference: cli, registry, proxy, protocol, sdk
  • Guides: connector, openclaw-skill, agent-to-agent, operator-controls, proxy-setup, discovery
  • Concepts: identity-model, revocation, security
  • Architecture: overview
  • Getting Started: introduction, quickstart, installation

Deployment

  • deploy-landing-develop.yml → triggers on develop, deploys preview to develop.clawdentity-site.pages.dev
  • deploy-landing.yml → triggers on main, deploys production to docs.clawdentity.com

Test plan

  • pnpm --filter @clawdentity/landing build passes (20 pages, 0 link errors)
  • Local dev server renders all pages correctly
  • Cloudflare Pages project clawdentity-site created in dashboard
  • Develop preview deployment succeeds after merge

…s deployment

Add Astro Starlight docs site covering all Clawdentity components:
- CLI reference (all commands, flags, and subcommands)
- Registry, Proxy, Protocol, and SDK API references with schemas and error codes
- Guides for connector, OpenClaw skill, agent-to-agent relay, and operator controls
- Architecture overview with D2 diagrams
- Getting started guides (intro, quickstart, installation)

Includes GitHub Actions workflows for develop (preview) and main (production)
deployments to Cloudflare Pages.
- Route pair confirm requests to the ticket issuer proxy origin instead of local resolved proxy URL.\n- Persist peer proxy URLs using profile proxyOrigin when available, with ticket issuer fallback.\n- Carry optional proxyOrigin through proxy pairing route/trust state models so status/confirm responses preserve responder origin.\n- Add CLI and proxy tests covering issuer-routed confirm and responder proxy URL persistence.\n- Update CLI/proxy AGENTS.md pairing rules to document proxyOrigin and issuer-routing requirements.
…s deployment

Add Astro Starlight docs site covering all Clawdentity components:
- CLI reference (all commands, flags, and subcommands)
- Registry, Proxy, Protocol, and SDK API references with schemas and error codes
- Guides for connector, OpenClaw skill, agent-to-agent relay, and operator controls
- Architecture overview with D2 diagrams
- Getting started guides (intro, quickstart, installation)

Includes GitHub Actions workflows for develop (preview) and main (production)
deployments to Cloudflare Pages.
- Create shared tokens.css with brand palette, Space Grotesk font stack, and weight scale
- Create starlight-custom.css with full Starlight override: teal/amber colors, glassmorphism nav, branded callouts, code block gradient accents, link hover animations, custom scrollbar, noise texture, page fade-in
- Update landing.css to import shared tokens, remove duplicate definitions, use font/weight variables
- Add Space Grotesk font loading to both landing layout and Starlight head config
- Add shield logo to Starlight sidebar header
- Update SVG logos from Inter to Space Grotesk font-family
- Include landing page components, assets, docs content updates, and D2 diagram regeneration
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