Skip to content

docs: custom RuleBox theme, home page and Visualizer intro video - #50

Merged
lmajano merged 1 commit into
developmentfrom
docs/custom-theme
Oct 3, 2026
Merged

lmajano merged 1 commit into
developmentfrom
docs/custom-theme

Conversation

@lmajano

@lmajano lmajano commented Oct 3, 2026

Copy link
Copy Markdown
Contributor

Description

A custom bx-sites theme for the RuleBox docs, in the style of the CbGenesis and bx-sites sites, built from the approved mockups.

  • Theme override (docs/.theme/): a copy of the stock bootstrap theme plus a new home.bxm landing page (layout: home on docs/index.md) styled by assets/home.css. The sections are:
    • Hero with a live code window and EXECUTED/SKIPPED badges.
    • Video tour.
    • Facts to result flow.
    • Features grid.
    • Code vs JSON.
    • Visualizer gallery.
    • Course band.
    • Platform strip and CTAs.
    • Footer.
  • Brand layer (docs/assets/brand.css, via extraCss): ColdBox blue to BoxLang green tokens and an ink dark mode for every docs page. Sora, Manrope and JetBrains Mono are self-hosted (OFL, see docs/assets/fonts/OFL.txt).
  • Assets: a RuleBox mark (logo and favicon), plus ColdBox and BoxLang icons.
  • Intro video: a 77s H.264 video (2 MB) with a poster. It has a title card, a tour of all five Visualizer screens with live traffic, an outro, and an end screen for rulebox.coldbox.org, with fade in, crossfades and fade out. It is embedded on the home page, the Visualizer guide and course lesson 9.
  • Image gallery: screenshots in the Visualizer guide and lesson 9 now use the bx-sites ::: image-gallery with lightbox (imageGallery: true).
  • build/video/: a Playwright recording script, a temporary demo handler and an ffmpeg cut script, so the video can be regenerated. build/ is already excluded from the package.

Docs only. No module code changes.

Note: docs/guides/visualizer.md is also touched by one-sentence edits in #30, #35 and #36, so whichever merges second may need a trivial conflict fix.

Issues

None. Requested directly.

Type of change

  • Improvement
  • This change requires a documentation update

Checklist

  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • Local bxSites build passes (25 pages). Playwright checks:
    • No JS errors, 4xx responses or broken images on the home page, getting started, the Visualizer guide, the DSL guide, the course index and lesson 9.
    • The home page renders in light, dark and phone widths.
    • The gallery lightbox opens.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Yc5MDcm3tyR2yqPWs9RpgX


Generated by Claude Code

- docs/.theme: bx-sites theme override with a new landing page (home.bxm,
  assets/home.css): hero with live code window, video tour, rule flow,
  features, code vs JSON, Visualizer gallery, course band, platform strip
- docs/assets/brand.css: ColdBox blue to BoxLang green tokens, ink dark
  mode, self-hosted Sora, Manrope and JetBrains Mono (OFL)
- RuleBox mark, ColdBox and BoxLang icons
- Visualizer intro video (77s, H.264) with poster, embedded on the home
  page, the Visualizer guide and course lesson 9
- Screenshots in the guide and lesson 9 now use the bx-sites image
  gallery with lightbox (imageGallery: true)
- build/video: Playwright recording script, demo handler and ffmpeg cut
  to regenerate the video

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Yc5MDcm3tyR2yqPWs9RpgX
@lmajano
lmajano merged commit 56387a4 into development Oct 3, 2026
10 checks passed
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