Blog

A minimal Rails blog that reads posts and pages from markdown files and ships as a static site with Parklife on GitHub Pages.

Stack

• Rails 8 with no database-backed features enabled
• importmap-rails and turbo-rails for the default Rails JavaScript stack
• tailwindcss-rails for styling
• kramdown for markdown rendering
• parklife and parklife-rails for static export

Content

Posts live in content/posts and use this frontmatter:

---
title: Starting With Rails and Markdown
slug: starting-with-rails-and-markdown
publish_date: 2026-04-04
tags:
  - rails
  - ai-engineering
---

Create a new post skeleton with:

bin/create-post your-post-slug

Pages live in content/pages and use:

---
title: About
slug: about
---

Routes:

• / lists posts
• /feed.xml serves the RSS feed
• /posts/:slug shows a post
• /:slug shows a page
• /tags/:slug shows the tag archive

Page slugs reserve posts, tags, and up, and generated routes are validated for uniqueness.

Local Development

Install gems:

bundle install

Run Rails:

bin/rails server

Turbo is enabled through importmap in app/javascript/application.js, and link prefetching is left at Turbo's default behavior.

Run Tailwind in watch mode in another terminal:

bin/rails tailwindcss:watch

Or run both together with:

bin/dev

Run tests:

bin/rails test

Static Build

Generate the static site locally:

bin/static-build

The exported site is written to build/.

If you want feed links to use a specific absolute URL locally, set SITE_URL before building or running the app.

GitHub Pages

The workflow at .github/workflows/parklife.yml builds the app with Parklife and deploys the build/ output to GitHub Pages when main is updated.