Skip to content

Add curated Reference Apps library#684

Open
robzolkos wants to merge 2 commits into
rails:mainfrom
robzolkos:reference-apps-library-clean
Open

Add curated Reference Apps library#684
robzolkos wants to merge 2 commits into
rails:mainfrom
robzolkos:reference-apps-library-clean

Conversation

@robzolkos

@robzolkos robzolkos commented Jun 29, 2026

Copy link
Copy Markdown

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 real apps: Campfire, Writebook, and Fizzy (all by 37signals)
  • 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
  • Six placeholder cards fill the grid while the library is curated;
    these are marked for removal before launch

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
image image

A new /docs/reference-apps page with a hand-picked library of exemplary
open-source Rails apps. Cards are image-led with screenshot, author eyebrow,
name, blurb, and tag pills — all driven from _data/reference_apps.yml.

Includes three real apps (Campfire, Writebook, Fizzy) and nine placeholder
entries to fill the grid while the library is curated. Placeholder entries
are marked for removal before launch.

Also adds a card to the /docs index page linking to the new page.
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.

2 participants