Skip to content

docs: apply HyperFrames design system to Mintlify theme - #225

Merged
jrusso1020 merged 7 commits into
mainfrom
docs/design-system-theme
Apr 8, 2026
Merged

docs: apply HyperFrames design system to Mintlify theme#225
jrusso1020 merged 7 commits into
mainfrom
docs/design-system-theme

Conversation

@jrusso1020

Copy link
Copy Markdown
Collaborator

Summary

  • Replaces the default cyan Mintlify theme with the HyperFrames brand design system (warm neutrals, near-black primary, Inter + IBM Plex Mono fonts)
  • Adds docs/custom.css with full light/dark mode CSS variables, code block styling, and heading letter-spacing
  • Adds DESIGN.md to the repo root as a design system reference for future docs/UI work
  • Fixes a CI gap where DOCS_GUIDELINES.md changes on push to main didn't trigger docs validation

Changes

File What changed
docs/docs.json Theme mintmaple, cyan → warm neutral palette, added Inter/IBM Plex Mono fonts, light mode default
docs/custom.css New — CSS variables for both modes, IBM Plex Mono import, heading tracking, code block borders
docs/template-gallery.css Replaced box-shadow hover with border-color (flat aesthetic)
DESIGN.md New — full design system reference (colors, typography, spacing, component patterns)
.github/workflows/docs.yml Added DOCS_GUIDELINES.md to push trigger paths

Test plan

  • npx mint validate passes
  • npx mint broken-links passes
  • Preview deploy — verify light/dark mode colors, Inter font rendering, IBM Plex Mono in code blocks
  • Spot-check template gallery hover states use border instead of shadow

🤖 Generated with Claude Code

Update docs config and add custom CSS to match the HyperFrames brand:
- Switch theme from mint to maple, replace cyan palette with warm neutrals
- Add Inter (body/headings) and IBM Plex Mono (code) fonts
- Add custom.css with full light/dark mode CSS variables
- Default to light mode appearance
- Replace box-shadow hover effects with border-color (flat aesthetic)
- Add DESIGN.md to repo root as design system reference
- Fix docs CI to also trigger on DOCS_GUIDELINES.md pushes to main

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@mintlify

mintlify Bot commented Apr 8, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
hyperframes 🟢 Ready View Preview Apr 8, 2026, 2:15 AM

Replace 41KB HeyGen SVG logos with lightweight (~400B) text-based SVGs
rendering "HyperFrames" in Inter semibold with tight tracking, matching
the wordmark style on hyperframes.heygen.com.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Match the exact font rendering from hyperframes.heygen.com:
- Load ABC Solar Display Bold from HeyGen static assets CDN
- SVGs use 15.2px/600w/-0.15 letter-spacing (matches computed styles)
- Dark mode fill matches rgb(240,240,240) from the website
- Add @font-face in custom.css for site-wide availability
- Fix lefthook: remove css from oxfmt glob (oxfmt doesn't support CSS)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
SVG <text> elements don't render custom fonts when loaded as <img>
(browser security restriction). Convert the ABC Solar Display glyphs
to SVG paths extracted from the font outlines — renders identically
everywhere with zero font dependency. Remove @font-face for the
display font from custom.css since it's no longer needed.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Use TT Norms Pro (from HeyGen static assets CDN) to match
hyperframes.heygen.com. Loads weights 400-700 via @font-face
with Inter as fallback.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@jrusso1020
jrusso1020 merged commit fe9cd30 into main Apr 8, 2026
15 checks passed
@jrusso1020
jrusso1020 deleted the docs/design-system-theme branch April 8, 2026 03:24
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.

2 participants