Getting Started

Installation

gem install quartermaster

Create a Static Site

qm new my-site
cd my-site
npm install
npm run dev

Quartermaster prompts for site name, description, author, and optional integrations (GA4, Web3Forms). Use --skip-prompts for defaults.

Create a Rails App

qm new my-app --mode=rails
cd my-app
bin/rails db:create db:migrate
bin/dev

Requires Rails CLI installed. Generates a Rails 8+ app with PostgreSQL, Propshaft, Tailwind CSS, Solid Queue/Cache/Cable, and built-in authentication.

Generate Components

Inside a Quartermaster project, generate pages, controllers, posts, and projects:

qm generate page about
qm generate controller toggle
qm generate post "My First Post"
qm generate project "Custom Bookshelf" --category=Furniture

Promote to Rails

Convert a static site to a Rails application:

cd my-site
qm promote --to=rails

Creates a sibling Rails app with your pages converted to ERB views, data files converted to YAML config, a PagesController wired up, and all Stimulus controllers and CSS transferred untouched.