RubySchema

Your editor already knows how to validate YAML, JSON and TOML — it just needs the right schemas.

Ruby gems love configuration files. Between YAML’s ambiguous booleans, invisible whitespace bugs and Ruby’s insistence on the 1.1 spec, those files are a minefield. You won’t know something’s wrong until production tells you.

RubySchema provides JSON Schema definitions for popular gems so your editor can catch mistakes, suggest keys and surface documentation as you type.

Quick Start

bin/rails app:template LOCATION=https://www.rubyschema.org/rails.rb

Injects schema comments into your Rails config files. Safe to re-run when new schemas are added.

Manual Setup

# yaml-language-server: $schema=<url>
{ "$schema": "<url>" }
#:schema <url>

Schemas

Rails
Database database.yml rubyschema.org/rails/database.json
Storage storage.yml rubyschema.org/rails/storage.json
Cable cable.yml rubyschema.org/rails/cable.json
Cache cache.yml rubyschema.org/rails/cache.json
Queue queue.yml rubyschema.org/rails/queue.json
Recurring recurring.yml rubyschema.org/rails/recurring.json
Deployment & CI
Kamal deploy.yml rubyschema.org/kamal/deploy.json
Lefthook lefthook.yml rubyschema.org/lefthook.json
Code Quality
RuboCop .rubocop.yml rubyschema.org/rubocop.json
Standard .standard.yml rubyschema.org/standard.json
Packwerk package.yml rubyschema.org/packwerk/package.json
Background Jobs
Sidekiq sidekiq.yml rubyschema.org/sidekiq.json
Shoryuken shoryuken.yml rubyschema.org/shoryuken.json
Monitoring
Honeybadger honeybadger.yml rubyschema.org/honeybadger.json
RoRvsWild rorvswild.yml rubyschema.org/rorvswild.json
Scout APM scout_apm.yml rubyschema.org/scout_apm.json
PgHero pghero.yml rubyschema.org/pghero.json
I18n
Locale files locales/*.yml rubyschema.org/i18n/locale.json
i18n-tasks i18n-tasks.yml rubyschema.org/i18n-tasks.json
Other
Mongoid mongoid.yml rubyschema.org/mongoid.json
Vite Ruby vite.json rubyschema.org/vite.json