Monolith

A quick way to spin up a Monlithic Rails application. Rocketship uses Monolith when building new SaaS applications.

Monolith includes a Rails engine with development tools for inspecting your application:

• Email previews
• Database table browser
• Installed gems viewer
• Route inspector
• Model inspector
• Rails generators interface

The engine automatically mounts at http://localhost:3000/monolith in development mode.

Install the gem and add to the application's Gemfile by executing:

$ gem install rubymonolith

Run the CLI utility to create a monolith:

$ monolith new my-rad-project

Monolith creates a new Rails project with the dependencies needed to be productive.

Add to your Gemfile:

gem 'rubymonolith'

Run bundle install and the engine automatically mounts at http://localhost:3000/monolith in development.

To see available generators, run rails generate --help.

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

The engine includes a pre-compiled Tailwind CSS file with daisyUI committed to the repo. When developing the gem:

npm install                     # Install daisyUI
bin/build                       # Build CSS once
rake monolith:tailwind:watch    # Watch and rebuild on changes

The engine uses Tailwind v4 with CSS-based configuration and daisyUI for components and dark mode support. The compiled CSS is committed so users don't need Tailwind or npm installed.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/rubymonolith/monolith.