# dao42/rails-template

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

~~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-7x-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 7, using `propshaft`
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 3.x, and install `rails 6.1.x`

    ```bash
    $ ruby -v ( output should be 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 7.2.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`

    // -A: no pipeline, -J: no js( rails-template will create them by self)
    `$ rails new myapp -A -J -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.

    `$ bin/dev`

## What we do

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

1. `ActionCable` and `Turbo` 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 4` 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 7.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 4](https://github.com/ColorlibHQ/AdminLTE)

## 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)

## 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