Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dao42/rails-template

A best & newest & fastest rails 6.x template for senior rails developer.
https://github.com/dao42/rails-template

rails template

Last synced: about 2 months ago
JSON representation

A best & newest & fastest rails 6.x template for senior rails developer.

Awesome Lists containing this project

README

        

# dao42/rails-template

**dao42/rails-template has supported the newest rails 6.1.x project setup**

Maybe the best & newest & fastest rails template for senior rails developer.

It maybe the best starting for your new rails project.

An example built with rails-template: https://github.com/dao42/rails-template-example

## Core Idea

`dao42/rails-template` apply lots of good components for you to make development damn quick.

1. `dao42/rails-template` keep the newest easily because it's a real `Rails Application Template`.
2. `dao42/rails-template` love the newest standard components of Rails 6, using `webpacker` and remove `assets pipeline`.
3. `dao42/rails-template` is out-of-box for your development based on `bootstrap4`.
4. `dao42/rails-template` is out-of-box for your deployment based on `mina`.

## How to use

Install dependencies:

* postgresql

```bash
$ brew install postgresql
```

Ensure you have already initialized a user with username: `postgres` and password: `postgres`( e.g. using `$ createuser -d postgres` command creating one )

* rails 6

Using `rbenv`, update `ruby` up to 2.7 or higher, and install `rails 6.1.x`

```bash
$ ruby -v ( output should be 2.7.x or 3.x )

$ gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.com/` (optional, Chinese developer recommend)

$ gem install rails

$ rails -v ( output should be rails 6.1.x )
```

* yarn

Install `npm`, `yarn` for webpacker( see install document: https://yarnpkg.com/en/docs/install)

```bash
$ yarn --version( output should be 1.6.x or higher )

$ npm config set registry https://registry.npm.taobao.org (optional, Chinese developer recommend)
```

Then,

1. Add `gems.ruby-china.com` to your bundle mirrors (optional, Chinese developer recommended)

`$ bundle config mirror.https://rubygems.org https://gems.ruby-china.com`

2. Create your own rails app applying `rails-template`

`$ rails new myapp -m https://raw.githubusercontent.com/dao42/rails-template/master/composer.rb`

Important!! replace `myapp` to your real project name, we will generate lots of example files by this name.

3. Done! Trying to start it.

`$ rails s`

## What we do

`rails-template` apply lots of good components for you to make development damn quick.

1. `ActionCable` and `Turbolinks` features are opened by default.

2. `Bootstrap4` and `font-awesome` are integrated to make your products UI easily, it aslo has some example pages for you to quickly start.

3. `active_storage` and `local` file mode are opened by default.

4. `mina` and its plugins are out-of-box for your deployment.

5. `slim`, `simple_form`, `kaminari`, `high_voltage` are installed.

6. `adminlte 3` is ready for your administrator dashboard.

7. `rspec`, `factory_bot_rails`, `database_cleaner` are ready for your testing automation.

8. Zero-down phase-restart mode is out-of-box with `mina-ng-puma`.

9. `monit`, `nginx example`, `https ssl example`, `logrotate`, `backup example` is ready for you.

Other gems integrated in rails-template are worth learning seriously.

## Integrated mainly technology stack and gems

* [Ruby on Rails 6.0](https://github.com/rails)
* [bootstrap 4](https://github.com/twbs)
* [font-awesome 5](https://github.com/FortAwesome)
* [figaro](https://github.com/laserlemon/figaro)
* [postgres](https://www.postgresql.org/)
* [slim](https://github.com/slim-template/slim)
* [simple_form](https://github.com/heartcombo/simple_form)
* [high_voltage](https://github.com/thoughtbot/high_voltage)
* [active_storage](https://github.com/rails/rails/tree/master/activestorage)
* [sidekiq](https://github.com/mperham/sidekiq)
* [kaminari](https://github.com/kaminari/kaminari)
* [mina](https://github.com/mina-deploy/mina)
* [puma](https://github.com/puma/puma)
* [rspec](https://github.com/rspec)
* [adminlte 3](https://github.com/ColorlibHQ/AdminLTE)

## Starting with webpacker document

* [Starting with webpacker for Rails 6(zh-CN)](https://ruby-china.org/topics/38832)

## Deployment document

* [How to deploy to ubuntu 16.10 with rails-template step by step(zh-CN)](https://github.com/dao42/rails-template/wiki/how-to-deploy-rails-to-ubuntu1404-with-rails-template)

## Roadmap

* [x] Add AdminLTE as admin dashboard

## Projects that using `dao42/rails-template`

Welcome to pull request here to update this if you choose `dao42/rails-template` for your new rails app.

* [danmai weapp SAAS platform](https://www.danmai.com.cn)
* [dao42 official website](https://www.dao42.com)
* [showmebug](https://www.showmebug.com)

## LICENSE

MIT