Skip to content

style: align visual theme with Agent Governance Toolkit#41

Merged
imran-siddique merged 6 commits into
mainfrom
feat/docs-site-upgrade
Jun 17, 2026
Merged

style: align visual theme with Agent Governance Toolkit#41
imran-siddique merged 6 commits into
mainfrom
feat/docs-site-upgrade

Conversation

@imran-siddique

Copy link
Copy Markdown
Contributor

Summary

Aligns the TRACE doc site visual design with Agent Governance Toolkit to signal that they are part of the same ecosystem.

Color palette:

  • Primary → #8251EE (AGT NextGen Purple) replacing #7c3aed
  • Dark mode accent → #5BD2BE (AGT teal) / #C661F7 (violet)
  • Dark mode background → #0d1117 (GitHub-neutral, matching AGT slate) replacing deep purple-black

Header treatment:

  • Plain canvas + 1px border-bottom (matches AGT)
  • 2px gradient accent strip: teal → purple → violet — same family as AGT's header strip
  • Removes the dramatic dark gradient header

Typography:

  • GitHub Primer system font stack (font: false disables Roboto)
  • Semibold headings, h2 border-bottom hairline (Primer style)

Logo:

  • Shape unchanged (shield + eye = trust attestation)
  • Gradient updated to teal → #8251EE → #C661F7 matching new palette

🤖 Generated with Claude Code

imran-siddique and others added 6 commits June 17, 2026 15:18
…, schema

Add 8 new documentation pages and overhaul mkdocs.yml:

New pages:
- docs/quickstart.md: 5-minute guide — keygen, emit, verify
- docs/verification.md: five-step offline verification protocol with
  code examples for signature, key resolution, hardware chain
- docs/schema.md: full field reference for all TRACE v0.1 claims
- docs/integration/agt.md: AGT integration — TraceConfig, key mgmt,
  Level 0 → Level 2 upgrade path
- docs/integration/cmcp.md: cMCP integration — architecture, Cedar
  policy example, MCP agent connection, platform matrix
- docs/platforms/amd-sev-snp.md: AMD SEV-SNP fields, verification,
  cloud instance table, on-premises support
- docs/platforms/intel-tdx.md: Intel TDX fields, PCCS verification
- docs/platforms/nvidia-h100.md: NVIDIA H100 CC, combined CPU+GPU
  attestation, GTC Berlin reference

mkdocs.yml:
- Expand nav: Getting Started / Integration / Platforms top-level tabs
- Add navigation.footer, navigation.expand, content.code.annotate,
  content.tooltips, search.share, navigation.instant.progress
- Add social links: PyPI, Discord, GitHub
- Add copyright, feedback ratings, version provider (mike)
- Set site_url to https://agentrust.io/trace (target domain)
- Remove examples/ from exclude_docs
- Add pymdownx.tasklist, pymdownx.keys, footnotes extensions
- custom_dir: docs/overrides for theme customisation

workflow: add concurrency group, pages/id-token permissions, git
config step, CNAME path trigger

CNAME: agentrust.io (custom domain for GitHub Pages)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
The original docs_dir: . caused a hard error in mkdocs >=1.6:
'docs_dir should not be the parent directory of the config file'

Fix: workflow now assembles a .docs_build/ directory with the correct
layout before invoking mkdocs, then generates a build-time config that
overrides docs_dir. All nav paths are preserved unchanged.

Also:
- Add pre-build Python assembly step to workflow
- Add concurrency group to prevent parallel deploys
- Add git config step
- Remove empty custom_dir from mkdocs.yml theme (would cause error)
- Keep docs_dir: . in source config (the workflow overrides it)
- Add social links, footer nav, better features to mkdocs.yml

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
yaml.safe_load rejects the Python-specific YAML tags used by mkdocs-material
(e.g. !!python/name:material.extensions.emoji.twemoji).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
yaml.full_load also fails (tries to import material.extensions.emoji at
parse time). Replace Python-based config generation with a simple sed
substitution and a shell-based file copy assembly step.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Primary color → #8251EE (AGT NextGen Purple) across light + dark
- Add teal→purple→violet gradient accent strip to header top edge
- Switch to GitHub Primer system font stack (font: false disables Roboto)
- Dark mode bg → #0d1117 (GitHub-neutral, matching AGT slate scheme)
- Update icon.svg gradient: teal→#8251EE→#C661F7 (teal→purple→violet)
- Add Primer-style h2 border-bottom, semibold headings
- Header: plain canvas + border-bottom (no gradient bg), same as AGT
- Tables, admonitions, code blocks: Primer border-radius + border style

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@imran-siddique imran-siddique merged commit b08fc20 into main Jun 17, 2026
1 of 5 checks passed
@imran-siddique imran-siddique deleted the feat/docs-site-upgrade branch June 17, 2026 23:29
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