Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/goldenowlasia/rails-view-template
Ruby on Rails boilerplate - view MVC
https://github.com/goldenowlasia/rails-view-template
boilerplate daisy-on-rails daisyui daisyui-rails golden-owl rails-template rails-templates ruby-on-rails vite-rails
Last synced: 28 days ago
JSON representation
Ruby on Rails boilerplate - view MVC
- Host: GitHub
- URL: https://github.com/goldenowlasia/rails-view-template
- Owner: GoldenOwlAsia
- Created: 2024-09-18T08:23:25.000Z (3 months ago)
- Default Branch: develop
- Last Pushed: 2024-11-22T10:58:23.000Z (about 1 month ago)
- Last Synced: 2024-11-22T11:27:07.991Z (about 1 month ago)
- Topics: boilerplate, daisy-on-rails, daisyui, daisyui-rails, golden-owl, rails-template, rails-templates, ruby-on-rails, vite-rails
- Language: Ruby
- Homepage:
- Size: 324 KB
- Stars: 2
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Rails boilerplate - From Golden Owl Solutions
This is a Rails boilerplate use rails 7.2
## Prerequisites
This project requires:
- Ruby (see [.ruby-version](./.ruby-version)), preferably managed using [rbenv](https://github.com/rbenv/rbenv) or [asdf](https://asdf-vm.com/)
- Node 20.9.0
- Yarn 1.x (classic)
- PostgreSQL must be installed and accepting connections
On macOS, these [Homebrew](http://brew.sh) packages are recommended:
```sh
brew install rbenv
brew install node 20.9.0
brew install yarn
brew install postgresql@16
brew install redis
```
## Getting started
## Install - setup app
To setup a development environment (MacOS):
**Clone the repo**:
```sh
git clone [email protected]:GoldenOwlAsia/rails-view-template.git
```
**Install Ruby**:
This project currently uses [Ruby 3.3.0](blob/staging/.ruby-version), which is most easily managed through a version manager like [asdf](https://asdf-vm.com/), [rbenv](https://github.com/rbenv/rbenv)
**Install Nodejs**:
This project user [Node 20.9.0](https://nodejs.org/en/blog/release/v20.9.0), which is most easily managed through a version manager like [asdf](https://github.com/asdf-vm/asdf-nodejs), [rvm](https://github.com/nvm-sh/nvm)
**Install Ruby gems**:
- install bundle version 2.5.4 (or similar if you are using an older version on your development)
```sh
gem install bundler -v 2.5.4
```
- bundle
```sh
bundle install
```
**Install Yarn**.
```sh
npm install -g yarn
```
**Install Javascript Packages**:
Install packages:
```sh
yarn
```
**Set the RACK_ENV (optional)**:
Later steps expect a `RACK_ENV` environment variable, so define one (usually 'development'.) This can be done by exporting a value in your shell config (by adding something like `export RACK_ENV=development` to your shell configuration file - `.bashrc`, etc)
**Personalise the app settings**:
- Copy `config/database.yml.sample` to `config/database.yml` and customise the values as needed.
- Copy `.env.sample` to `.env` and customise the values as needed.
**Run server**:
- rails server:
```sh
rails s
```
- sidekiq
```sh
bundle exec sidekiq
```
- Vite
```sh
vite dev
```
## Development
### ERD
- Using gem: `rails-mermaid_erd` - Its auto generate when run `rails db:migrate`
- Can see ERD at `http://localhost:3000/erd`
### FE references
- DaisyUI:
- For icons: lucide icon packages:
### Rspec
- Run test by:
```sh
bundle exec rspec
```
- Check test coverage at `coverage/index.html`
### ESLint
- ESLint check:
```sh
yarn lint
```
- ESLint check & auto fix:
```sh
yarn lint:fix
```
### Config Git hooks manager
- Use lefthook gem:
```sh
bundle exec lefthook install
```