Documentation

Everything you need to add blogging and content management to your Rails 8 application.

Looking for the user guide?

If you're looking for help using the RailsPress admin interface (creating posts, managing content groups, etc.), check out the Guide section.

Getting Started

Overview

Introduction to RailsPress, the blog engine and Entity System for Rails 8.

Installation

Add RailsPress to your Rails app, run migrations, and start creating content in minutes.

Core Features

Blogging

Create a full-featured blog frontend with posts, categories, tags, search, RSS feeds, and SEO.

Entity System

Manage any ActiveRecord model through the admin interface with the flexible Entity system.

Import & Export

Bulk import and export posts with markdown files and YAML frontmatter support.

Inline Editing

Edit content directly on the frontend with inline editing support.

Customization

Configuration

Configure authors, post images, authentication, and other options for your blog.

Theming

Customize the admin interface with CSS variables. Colors, typography, spacing, and component styling.

Admin Helpers

Reference for admin view helper methods. Form fields, layout components, and display utilities.

Focal Points

Set focal points on images to control cropping across different aspect ratios and contexts.

Reference

Troubleshooting

Common issues and solutions for installation, authentication, entities, and more.

Upgrading

How to upgrade between versions, copy new migrations, and handle breaking changes.

Quick Reference

Path Description
/railspress/admin Admin dashboard
/railspress/admin/posts Manage posts
/railspress/admin/categories Manage categories
/railspress/admin/tags Manage tags
/railspress/admin/imports/posts Import posts
/railspress/admin/exports/posts Export posts