A boilerplate to create Rails 6 apps in minutes.
Blueprint is a boilerplate to create Rails 6 apps easily and quickly.
Ideas/feedback/suggestions are welcome. Please open a PR to suggest a new feature.
- Built-in features
- Installation
- Sending Emails
- Customize Tailwind
- Flash Messages
- Form Validation
- Basic Admin Area
- Other Options
- Roadmap
Blueprint's goal is to make creating a modern Rails app as simple and fast as possible, which is why it comes with a few popular gems/plugins/libraries already set up:
- User authentication via Devise
- Login/Sign up pages already designed and easily customizable
- Script that handles flash messages
- Transactional emails sent via Postmark
- Easy CSS animations with Animated.css
- Design via TailwindCSS
- Troubleshoot problems faster with Better Errors
- Production-ready DB setup via postgres
- Google Analytics with Turbolinks support
- Preview emails in your browser (instead of sending them) in development with LetterOpener
- DotEnv for environment variables support
- Clone the repo
git clone git@github.com:ManuelFrigerio/rails-blueprint.git - Go to the folder
cd rails-blueprintand rungem install bundle && bundle install - Run
rails db:setup && rails db:migrateto create db and included Users table
Blueprint uses a few environment variables to set defaults and save you time.
You can see which environment variables you need in the .env-example file. In your development environment, rename the .env-example file to .env and restart the server.
To send emails Blueprint uses Postmark, an extremely realiable, developer-friendly and cheap ($10/month for 10K emails) email service. After you signup/login, create your first server and get your API key.
Simply make sure to set the POSTMARK_API_KEY variable in your environment with your Postmark API key.
By default, when you create a new mailer in Rails you have to create a folder under the views folder. However, if you have many mailers (eg: UserMailer, OrderMailer, NotificationMailer, etc), this often results in a messy view folder.
To solve this problem, Blueprint allows you to create you mailer folders under the new views/mailers folder.
When you create a new mailer (e.g: OrderMailer), simply create the corresponding folder (e.g: order_mailer) under the views/mailers folder.
Check out the user_mailer folder as an example.
Tailwind is a utility-first CSS framework to build custom designs. You can learn TailwindCSS for free here. When it makes sense to create re-usable components, the recommended approach is to add all the classes related to a component in a .scss file under app/javascript/css/components. Don't forget to also @import the file in the app/javascript/css/application.scss file.
Blueprint comes with 4 component files: Animations, Notifications, Buttons and Forms.
The animation.scss file ships the [Animate.css] library of CSS animations.
The notifications.scss file stores the CSS for the flash messages (check the flash messages section below).
The buttons.scss and forms.scss files store very simple classes to style buttons and form inputs. These files are used primarily to show how to use Tailwind.
Blueprint ships with a built-in JavaScript utility to handle flash messages. Flash messages will appear as notifications at the top of the screen for 3.5 seconds.
You can use 4 different type of flash messages:
flash[:notice] = "This is a notice notification"
flash[:error] = "This is a error notification"
flash[:success] = "This is a success notification"
flash[:warning] = "This is a warning notification"
Each flash type comes with a different colour.
You can manually trigger flash messages everywhere in your app with the following code:
showNotice("This is a notice notification");
showSuccess("This is a success notification");
showError("This is a error notification");
showWarning("This is a warning notification");
You can change the default position by adding a second parameter "bottom" to the function, like this:
showNotice("This is a notice notification", "bottom");
You can change the position of all flash messages in your app to bottom by editing the file layouts/scripts/flash, eg:
<% if flash[:success] %>
showSuccess("<%= flash[:success] %>", "bottom");
<% end %>
Form validations are also handled automatically. If any validations fail, the respective inputs will turn red as shown in the screenshot below.
This is done with the help of an initializer that overrides Rails's default behaviour and add a .border-red-500 class to the inputs that fail the validation. You can customize the error class by changing line 4 of the customize_errors.rb initializer.
You can also use flash messages to show validation errors. Blueprint has got a handy helper that you simply paste inside a form:
<%= form_for @object %>
<%= render "layouts/scripts/form_errors", obj: @object %>
<% end %>
A common functionality for Rails apps is the ability to log in as a specific user (usually to troubleshoot problems). Blueprint ships a very simple, yet flexible Admin Area that automatically lists all your users and allows you to log in as one of them with one click.
To see this page, visit the /admin path of your app. You will be prompted to authenticate (you don't want to expose this info to the world). The default login credentials are admin and password. Clearly, they are not very hacker-proof. You can change them in the admin/base_controller.rb file, line 4.
- If you are on Heroku, generate a master key by running this command
$ heroku config:set RAILS_MASTER_KEY=<your-master-key>Make sureyour-master-keyis an alphanumeric string 32 chars. - Go to devise.rb and change the default email address
config.mailer_sender - Create
.envfile and set your environment variables on your machine (see.env-example)
- ✅ Migrated to TailwindCSS
- ✅ Migrate to Rails 6
- ☑️ Add logic to handle subscriptions using Stripe's webhooks
- ✅ Basic admin dashboard which also allows to sign in as another user
- ☑️ Create a command line based script to customize the installation (add/remove gems, create tables, etc)
Feel free to implement anything from the roadmap, submit pull requests, create issues, discuss ideas or spread the word. When adding a gem, make sure to add clear instructions in the Installation section on how to use it.
Flash messages
Signup screen
