Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/nimblehq/rails-templates

Our optimized Rails templates used in our projects
https://github.com/nimblehq/rails-templates

docker rails-template ruby ruby-on-rails

Last synced: about 1 month ago
JSON representation

Our optimized Rails templates used in our projects

Awesome Lists containing this project

README

        


Nimble logo


Rails Templates

---

Our templates offer a rich boilerplate to jump start Rails-based application development and are based on our experience
with building complex applications over the years.

## Get Started

### Requirements

- Install ruby and set your local ruby version to `3.3.1`
- Install rails `7.1.3`
- Install node `22.1.0` (For creating web application)

> 📝 If running on Apple M1, to build docker image, please make sure to set platform to AMD64 by `export DOCKER_DEFAULT_PLATFORM=linux/amd64`

### Use the template

In order to use the template, initialize a new app with the following parameters:

```sh
rails new -m https://raw.githubusercontent.com/nimblehq/rails-templates/main/template.rb
```

Supported template options:
- `--api` - create an api-only application

To apply the template on an existing application, run following rails command:

```sh
rails app:template LOCATION=https://raw.githubusercontent.com/nimblehq/rails-templates/main/template.rb

# To apply on an api application
rails app:template LOCATION=https://raw.githubusercontent.com/nimblehq/rails-templates/main/template.rb API=true

# To apply a specific addon
rails app:template LOCATION=https://raw.githubusercontent.com/nimblehq/rails-templates/main/template.rb ADDON=
```

Available Addons:
- `docker`
- `nginx`
- `phrase`
- `bootstrap`
- `slim`
- `devise`

After the template finishes generating all the files, run the following command to start the rails server.

```sh
make dev
```

Read more about Rails Application Template in the [official Rails Guides](https://guides.rubyonrails.org/rails_application_templates.html).

## Contribution Resources

- [Contributions Guidelines](../../wiki/Contribution_Guide).
- [Testing the template](../../wiki/Testing)

## License

This project is Copyright (c) 2014 and onwards. It is free software,
and may be redistributed under the terms specified in the [LICENSE] file.

[LICENSE]: /LICENSE

## About

![Nimble](https://assets.nimblehq.co/logo/dark/logo-dark-text-160.png)

This project is maintained and funded by Nimble.

We love open source and do our part in sharing our work with the community!
See [our other projects][community] or [hire our team][hire] to help build your product.

[community]: https://github.com/nimblehq
[hire]: https://nimblehq.co/