Basic Sinatra v2 App with Sprockets, Warden, ActiveRecord and PostgresQL
Take this as a working example and as an inspiration. Pull Requests are welcome
Have you tried Roda?
think sinatra is nice? Don't forget to give Roda a chance!
What this Project aims to be
This repository aims to be a boilerplate for a modular and modern (v2) Sinatra app.
demo on heroku (admin area is locked up
please check out the credits section! Without the community, this never would have been possible. Thank you.
Feel free to contribute, add more features, strip features or simply improve existing code - pull requests welcome
Why not Rails?
Sinatra is a ruby/rack framework, that can be used as an alternative where Rails would simply be an overkill.
I started working my way through the sinatra docs, aiming for a setup that can easily be modeled to a basic use case.
Have you tried Roda, Sequel and Rodauth?
Yes! And I totally use that setup whenever possible (November 2021) and you should try at least roda as a POC
What is in?
I want this Sinatra boilerplate app to:
- work with Bundler
- use ORM is ActiveRecord
- have an MVC-like structure
- support Sass/Scss and CoffeeScript
- party with jQuery and Turbolinks! Yes, Turbolinks.
- rolls with a very basic bcrypt/warden based Authentication System
- use PostgresQL as Database
- run on heroku (don't forget:
$ heroku config:add APP_ENV=production
)
Get started
You need Ruby (>= 2.7) and Bundler (of course).
Have you heard of frozen_string_literal? No? Read this
If you do not have a local PostgresQL DB running, heroku can handle the code as is - do not forget to add Heroku PostgresQL addon in your dashboard.
$ git clone
$ bundle install
- edit config/database.yml
$ rake db:setup
$ thin start
orrerun rackup
(rerun gem - not included by default!)- edit titles in views/layout.haml and views/nav.haml
- check/set timezone config/timezone.rb
now what?
- read the credits
- read the code
- run the code, see what it does
- delete what you don't need and built from there, should a barebone branch be offered? What do you think?
😁
Most code is commented, so you'll learn what it does.
What needs to be done
- enable flash messages, especially for validation feedback
Contribute
- Send in pull requests, improve this project with features or simply by adding/improving comments
😁 - Be nice, make public forks
- What did you use this app for? Please, let me know! Share your projects.
Credits / Blood, Sweat & Tears
Contributors to this project
https://github.com/simonneutert/sinatras-skeleton/graphs/contributors
thank you for open sourcing, writing documentation, blogging, answering and giving a hand on stackoverflow
Warden
ActiveRecord + PostgresQL
BCrypt
Kieran's Answer on StackOverflow
Sprockets
Official Sinatra Docs