Skip to content

feat(docs): port terminal/editor chrome from marketing site#34

Merged
rhuanbarreto merged 4 commits into
mainfrom
feat/docs-terminal-chrome
Mar 1, 2026
Merged

feat(docs): port terminal/editor chrome from marketing site#34
rhuanbarreto merged 4 commits into
mainfrom
feat/docs-terminal-chrome

Conversation

@rhuanbarreto

@rhuanbarreto rhuanbarreto commented Mar 1, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds the "ADRs that enforce themselves" showcase section from archgate.dev to the docs landing page — three visual panels showing the ADR → Rules → Terminal output flow
  • Creates CodeShowcase.astro component with scoped CSS matching the marketing site aesthetic (dark chrome, macOS dots, hand-crafted syntax highlighting)
  • Configures Expressive Code styleOverrides so all code blocks site-wide match the same visual language
  • Adds custom.css for accent colors, selection theming, and scrollbar styling
  • Includes pt-br translation of the showcase section

Test plan

  • Run cd docs && bun run build — verified locally, builds clean
  • Preview the docs landing page and compare the showcase with archgate.dev
  • Verify the pt-br landing page renders the translated showcase
  • Check that regular code blocks (editor-framed and terminal-framed) throughout the docs also look consistent

🤖 Generated with Claude Code

rhuanbarreto and others added 4 commits March 1, 2026 17:44
Style code blocks in the CLI docs to match the archgate.dev marketing
site aesthetic — dark title bars (#1a1a1a), macOS-style dots, #0f0f0f
code backgrounds, flat design with no shadows, and matching scrollbar
and selection colors.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Port the three-panel visual showcase from archgate.dev into the docs
landing page: ADR file + Rules file side-by-side, with terminal output
below showing `archgate check` results. Replaces the plain directory
tree with an interactive visual that demonstrates the full ADR-to-check
flow. Includes pt-br translation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Astro scopes <style> selectors with a unique class, but spans injected
via set:html don't receive it. Wrap hl-* selectors with :global() so
they match the unscoped spans inside code panels.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Use CSS custom properties with [data-theme] selectors for light/dark
- Add not-content class to opt out of Starlight's prose styles that
  broke panel alignment
- Set panel background so dark bg fills the entire window frame
- Light palette: #f8f9fa bg, #eef0f2 chrome, darker syntax colors

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@rhuanbarreto rhuanbarreto merged commit 9d11476 into main Mar 1, 2026
2 checks passed
@rhuanbarreto rhuanbarreto deleted the feat/docs-terminal-chrome branch March 1, 2026 17:36
@archgatebot archgatebot Bot mentioned this pull request Mar 1, 2026
rhuanbarreto added a commit that referenced this pull request Mar 3, 2026
* feat(docs): port terminal/editor window chrome from marketing site

Style code blocks in the CLI docs to match the archgate.dev marketing
site aesthetic — dark title bars (#1a1a1a), macOS-style dots, #0f0f0f
code backgrounds, flat design with no shadows, and matching scrollbar
and selection colors.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(docs): add "ADRs that enforce themselves" showcase section

Port the three-panel visual showcase from archgate.dev into the docs
landing page: ADR file + Rules file side-by-side, with terminal output
below showing `archgate check` results. Replaces the plain directory
tree with an interactive visual that demonstrates the full ADR-to-check
flow. Includes pt-br translation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(docs): use :global() for set:html syntax highlight spans

Astro scopes <style> selectors with a unique class, but spans injected
via set:html don't receive it. Wrap hl-* selectors with :global() so
they match the unscoped spans inside code panels.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(docs): add light mode support and fix panel alignment

- Use CSS custom properties with [data-theme] selectors for light/dark
- Add not-content class to opt out of Starlight's prose styles that
  broke panel alignment
- Set panel background so dark bg fills the entire window frame
- Light palette: #f8f9fa bg, #eef0f2 chrome, darker syntax colors

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
rhuanbarreto added a commit that referenced this pull request Mar 4, 2026
* feat(docs): port terminal/editor window chrome from marketing site

Style code blocks in the CLI docs to match the archgate.dev marketing
site aesthetic — dark title bars (#1a1a1a), macOS-style dots, #0f0f0f
code backgrounds, flat design with no shadows, and matching scrollbar
and selection colors.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(docs): add "ADRs that enforce themselves" showcase section

Port the three-panel visual showcase from archgate.dev into the docs
landing page: ADR file + Rules file side-by-side, with terminal output
below showing `archgate check` results. Replaces the plain directory
tree with an interactive visual that demonstrates the full ADR-to-check
flow. Includes pt-br translation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(docs): use :global() for set:html syntax highlight spans

Astro scopes <style> selectors with a unique class, but spans injected
via set:html don't receive it. Wrap hl-* selectors with :global() so
they match the unscoped spans inside code panels.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(docs): add light mode support and fix panel alignment

- Use CSS custom properties with [data-theme] selectors for light/dark
- Add not-content class to opt out of Starlight's prose styles that
  broke panel alignment
- Set panel background so dark bg fills the entire window frame
- Light palette: #f8f9fa bg, #eef0f2 chrome, darker syntax colors

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This was referenced Mar 4, 2026
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