Anonymous View
Skip to content

Visual redesign: new hero/nav/footer, PicoCSS styling, refreshed copy#63

Open
johngallagher wants to merge 1 commit into
jruby:masterfrom
johngallagher:redesign-2026
Open

Visual redesign: new hero/nav/footer, PicoCSS styling, refreshed copy#63
johngallagher wants to merge 1 commit into
jruby:masterfrom
johngallagher:redesign-2026

Conversation

@johngallagher

Copy link
Copy Markdown

Summary

This is a proposal to refresh the look of jruby.org, prototyped first at johngallagher/diamond and ported here. Per the README's note to consult before large changes, I'd like this to be a starting point for discussion rather than something to merge as-is -- happy to iterate or narrow scope based on feedback.

  • New hero, nav (with mobile hamburger), and footer, built on a locally vendored PicoCSS (classless) plus a new stylesheets/style.css. Removes the old main.css/carousel.css/ie7-hacks.css and the Typekit font loader (left on disk, just unreferenced).
  • Refreshed prose on getting-started, documentation, community, contribute, security, and blogs. I deliberately left nightly and chat untouched -- their current copy (Sonatype Central links, Matrix logs, IRC bridge) is already more accurate/current than what the prototype had, so replacing it would have been a regression.
  • Adds a Twitter card back into the Community page grid so /twitter stays linked from somewhere (the prototype had dropped it).

What's deliberately unchanged

  • Release automation: rakelib/release.rake's change_versions_in does plain text substitution of version strings in download.html and _config.yml on every release. I restyled download.html by wrapping each release block in a <div class="release-card"> only -- diffed against master to confirm every version string, URL, and bit of release text is byte-for-byte identical otherwise. _config.yml is untouched entirely.
  • Favicons/PWA: site.webmanifest, browserconfig.xml, and the existing favicon/touch-icon images are untouched.
  • Analytics: the Google Analytics snippet (_includes/tracking.html) is still included on every page in the same position.
  • Existing homepage features: the Recent News teaser, Recent Toots Mastodon embed, InfoWorld Bossie award, and Engine Yard hosting credit are all still there, just restyled to match the new look rather than removed.
  • _posts/, Rakefile, cookbooks/, conf/, config.ru, patches/, templates/, files/, apidocs/, CNAME, .htaccess, robots.txt, atom.xml, Gemfile -- none of these were touched.
  • Old stylesheets/, javascripts/, and images/ are left on disk even where now unreferenced, rather than deleted -- a couple of old posts embed images directly (e.g. jruby-bug-chart-jan-2010.png), and there may be external hotlinks I can't see. Happy to clean these up in a follow-up if maintainers prefer.

One thing to flag explicitly

The footer now includes a "Professional Support" link to Headius Enterprises. This was coordinated directly with the Headius team beforehand -- flagging it here so it's not a surprise in review.

Test plan

  • bundle exec jekyll build succeeds with no new warnings (the pre-existing Layout 'nil' requested in atom.xml warning is present on master too)
  • Diffed download.html and _config.yml against master to confirm only CSS wrapper divs were added around release blocks, no text/URL changes
  • Spot-rendered and checked index.html, download.html, news.html, a _posts entry, security.markdown, and 404.html -- nav links resolve, the release widget shows live site.release data, and the homepage's Mastodon/awards/Engine Yard sections still render
  • Would appreciate a maintainer double-checking the live rake deploy/rake server flow, since I could only verify via jekyll build locally

🤖 Generated with Claude Code

Ports a community-built visual redesign (prototyped at
github.com/johngallagher/diamond) onto the existing site structure.

- Vendors PicoCSS classless + a new style.css, replacing main.css/
  carousel.css/ie7-hacks.css and the Typekit font loader.
- Restyles menu/banner/release/footer includes and the main/home/post
  layouts; all existing nav destinations, the release widget, the
  Recent News/Recent Toots (Mastodon)/Awards/Engine Yard sections on
  the homepage, and Google Analytics tracking are preserved, just
  restyled.
- Refreshes prose on getting-started, documentation, community,
  contribute, security, and blogs. Left nightly/chat untouched since
  their existing copy is more current than the prototype's.
- download.html and _config.yml are untouched apart from added CSS
  wrapper divs around each release block -- the exact version/URL
  text that rakelib/release.rake's change_versions_in substitutes on
  every release is preserved byte-for-byte (verified by diff).
- Adds an authorized Headius Enterprises support banner/footer link
  (coordinated directly with the Headius team).
- Leaves old stylesheets/, javascripts/, and images/ in place
  unreferenced rather than deleting them, since some images are
  embedded in historical posts and external links may target them.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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