Skip to content

Redesign docs site + add deep-dive articles#12

Merged
everettjf merged 1 commit into
masterfrom
docs/site-redesign
Jun 1, 2026
Merged

Redesign docs site + add deep-dive articles#12
everettjf merged 1 commit into
masterfrom
docs/site-redesign

Conversation

@everettjf

Copy link
Copy Markdown
Owner

Overhauls the GitHub Pages site into a polished, custom-designed documentation site and expands it to 21 pages.

Design

  • Drops the stock cayman theme for custom Jekyll layouts + a hand-built stylesheet.
  • Dark/light themes (persisted toggle), Fraunces display + Spline Sans body + JetBrains Mono code, coral accent, dot-grid + glow atmosphere.
  • Terminal-style code panels with copy buttons and a tuned Rouge palette, sticky sidebar nav with active state, scrollspy "On this page" TOC, heading anchors, responsive mobile drawer.
  • Landing page: hero, highlighted code card, feature grid, guide cards.

Content (10 new + reworked guides)

  • Concepts: How it works · Method replacement internals · The type bridge · Security model · Performance · Comparison
  • Guides: Objective-C in depth (new) + restyled Authoring / Swift / Structs / Blocks / Diagnostics / Remote delivery / Signing / Integration
  • Case studies: Obj-C crash hotfix · Swift feature gating
  • Reference: FAQ & troubleshooting

Verification

  • Builds clean with Jekyll 4.4.1 locally (the Actions workflow uses the same pages/ source).
  • All internal links converted to .html; 560 rendered links checked, 0 broken; all 21 sidebar targets generate.
  • Local build output (pages/_site, .jekyll-cache) is gitignored.

Merging deploys automatically (Pages is enabled; the workflow runs on pages/** changes).

🤖 Generated with Claude Code

Replace the bare cayman theme with a custom, polished design and expand the
content to a full documentation site (21 pages).

Design:
- Custom Jekyll layouts/includes (default/doc/home) + a hand-built stylesheet:
  dark/light themes (toggle, persisted), Fraunces + Spline Sans + JetBrains
  Mono, coral accent, dot-grid + glow atmosphere, terminal-style code panels
  with copy buttons, sticky sidebar nav with active state, scrollspy "On this
  page" TOC, heading anchors, and a responsive mobile drawer.
- Landing page with hero, highlighted code card, feature grid, and guide cards.

Content (10 new articles + reworked guides):
- Concepts: how-it-works, method-replacement, type-bridging, security,
  performance, comparison.
- Guides: Objective-C in depth (new) plus restyled authoring/swift/structs/
  blocks/diagnostics/remote-delivery/signing/integration.
- Case studies: Obj-C crash hotfix, Swift feature gating.
- FAQ & troubleshooting.

Internal links converted to .html and verified (560 rendered links, 0 broken);
site builds clean with Jekyll. Local build output gitignored.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@everettjf everettjf merged commit 8bb5b47 into master Jun 1, 2026
4 checks passed
@everettjf everettjf deleted the docs/site-redesign branch June 1, 2026 17:52
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