- Important
# frozen_string_literal: true
does not work with Sinatra 2.x, sinatra/sinatra issue #1209
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 ๐
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.
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.
- roll an Authentication System
- use PostgresQL as Database
- run on heroku (don't forget:
$ heroku config:add APP_ENV=production
)
You need Ruby (>= 2.4) 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
- 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.
- enable flash messages, especially for validation feedback
- 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.
โค๏ธ ๐ ๐ญ
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