Skip to content

Add curated Reference Apps library#684

Merged
AmandaPerino merged 2 commits into
rails:mainfrom
robzolkos:reference-apps-library-clean
Jul 24, 2026
Merged

Add curated Reference Apps library#684
AmandaPerino merged 2 commits into
rails:mainfrom
robzolkos:reference-apps-library-clean

Conversation

@robzolkos

@robzolkos robzolkos commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Adds a new /docs/reference-apps page — a hand-picked library of exemplary open-source Rails apps, intended to show how real, production-quality Rails applications are built.

What's included:

  • New page at /docs/reference-apps with an image-led card grid
  • Three curated 37signals apps: Campfire, Writebook, and Fizzy
  • Cards show a screenshot, author, name, blurb, and tag pills
  • All content is data-driven via _data/reference_apps.yml — adding or editing an app requires no HTML changes
  • Link card added to the /docs index page

Design notes:

  • Cards stretch to equal height per row with tags pinned to the bottom
  • Screenshot images are flush to card edges, clipped to rounded corners
  • First card loads eagerly (LCP); subsequent cards are lazy-loaded

Verification:

  • ruby -ryaml -e 'data=YAML.load_file("_data/reference_apps.yml"); abort "expected 3 apps" unless data.fetch("apps").size == 3; abort "mock screenshots remain" if data.fetch("apps").any? { |app| app["screenshot"].to_s.include?("mock-") }; puts "✓ reference_apps.yml has exactly 3 non-mock apps"'
  • BUNDLE_USER_HOME=/tmp/rails-website-bundle-home BUNDLE_PATH=/tmp/rails-website-bundle bundle exec jekyll build

image

image

@dhh

dhh commented Jul 23, 2026

Copy link
Copy Markdown
Member

Is there anything else we need for this to go live?

@rafaelfranca

Copy link
Copy Markdown
Member

We need to remove all the placeholders and then we can merge this.

@robzolkos
robzolkos force-pushed the reference-apps-library-clean branch 2 times, most recently from 01fca49 to 01bd64c Compare July 23, 2026 21:57
@robzolkos
robzolkos force-pushed the reference-apps-library-clean branch from 01bd64c to c256e86 Compare July 23, 2026 21:59
@dhh

dhh commented Jul 23, 2026

Copy link
Copy Markdown
Member

Would be nice if the Study the reference apps block was centered instead of left aligned. Feels like it's dangling a little. Otherwise good.

@robzolkos

Copy link
Copy Markdown
Contributor Author

@dhh done image

@dhh

dhh commented Jul 24, 2026

Copy link
Copy Markdown
Member

Oh ha. I thought we actually had more examples than just the three from 37s! My mistake 😄. But yes, let's just go with this anyway for now if this is what we have. Hopefully we'll soon see more we can add.

@AmandaPerino
AmandaPerino merged commit a15f85f into rails:main Jul 24, 2026
robbyrussell pushed a commit to robbyrussell/rubyonrails-website that referenced this pull request Jul 24, 2026
* Add curated Reference Apps library

* Center orphan docs card
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants