andrewmcodes/shotgun

Ready to go Rails App with TailwindCSS, ViewComponent, Devise, and more!

WIP: Rails Shotgun

Ruby on Rails application initialized with all the good stuff. Use at your own risk or we welcome pull requests. I will be working on a roadmap soon.

Why is it named Shotgun??

Shotgunning a beer is the simple act of consuming a beer at a high rate of speed.

The inspiration came from one of my common college activities. Rails Shotgun lets you be as productive as shotgunning a beer is at getting you drunk.

Setup

Please take note that we are using main as the base branch.

System dependencies

• Ruby version: 2.7.1
• Rails version: 6.0.3.2
• Database: PostgreSQL
• Redis installed

Rename Application

You will want to rename the application first. Here are some options:

• Watch the CodeTour
• Find and replace CHANGEME throughout. Note that if you take this method, you need to be aware of using the correct case.

Configuration

Make sure the app has been renamed before doing these steps.

Automated

bin/setup

Manually

Copy an existing sample environment file. Run:

```bash
$ cp .env.sample .env

and edit newly created .env file. The minimum you are going to need are credentials to your local PostgreSQL database.

Then, install all the necessary dependencies:

bundle install && yarn install

Database creation

In order to create the database with all the necessary seed data, run:

rails db:create db:schema:load db:seed

How to start the app

Start the Ruby on Rails server with:

rails server

We highly recommend running the weback dev server in another tab instead of inline compilation that will occur if you don't for speed.

bin/webpack-dev-server

To optionally run Sidekiq, launch another process with:

bundle exec sidekiq

Code quality checks

The application provides the following code quality analysis tools:

• Brakeman
• Fasterer
• Rails Best Practices
• Bundler Audit

To run them locally:

$ bundle exec brakeman
$ bundle exec fasterer
$ bundle exec rails_best_practices
$ bundle audit

Removed Gems

• redis-namespace
  • Not needed and it was throwing a bunch of warnings.
• active-record-observer
  • Unused
• activeresource
  • Unused
• ngrok-tunnel
  • Not needed if using tmuxinator
• better_errors
  • Not really needed anymore now that Rails has made some improvements that made this a real nice-to-have

Changelog

Coming Soon

Contributing

Contributing Guide

Code of Conduct

Code of Conduct

License

MIT

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Andrew Mason 💻 🤔 🚇 🚧 👀 💬

cjilbert504 💻 🐛

This project follows the all-contributors specification. Contributions of any kind welcome!

shotgun's Issues

Stop checking yarn integrity in development

Describe the bug

Running bin/setup will likely fail because the yarn packages may be out of date. This isn't a concern and we should disable the behavior, introduced by enabling check_yarn_integrity to true in the webpacker config.

Specifically this line should be removed as well as the comment above it. We set this to false in our defaults, so once this line is removed, we will no longer be overriding it in development and yarn install will stop failing.

To Reproduce

1. Create a new app with this template
2. Clone the app and cd into the folder
3. Run bin/setup

Expected behavior

This command executes and does not fail to yarn due to out of date js packages.

Update dependencies in README

https://github.com/andrewmcodes/shotgun#system-dependencies is out of date.

Sidekiq Web route bug

If you try to uncomment the sidekiq setup in the routes you will have issues because we need to add require 'sidekiq/web' at the top of the routes file.

shotgun/config/routes.rb

Line 5 in e53008a

# mount Sidekiq::Web => "/sidekiq"