Skip to content

Commit f4c5ab0

Browse files
committed
Fixed README
1 parent b8812a7 commit f4c5ab0

File tree

4 files changed

+52
-21
lines changed

4 files changed

+52
-21
lines changed

Gemfile

-1
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,6 @@ end
3939
group :development do
4040
gem 'annotate', '~> 3.2'
4141
gem 'letter_opener', '~> 1.8'
42-
gem 'reek', '~> 6.1.0', require: false
4342
gem 'rubocop-github'
4443
gem 'rubocop-performance', require: false
4544
gem 'rubocop-rails', require: false

Gemfile.lock

-6
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,6 @@ GEM
127127
io-wait (0.2.1)
128128
jb (0.8.0)
129129
jwt (2.3.0)
130-
kwalify (0.7.2)
131130
launchy (2.5.0)
132131
addressable (~> 2.7)
133132
letter_opener (1.8.0)
@@ -221,10 +220,6 @@ GEM
221220
zeitwerk (~> 2.5)
222221
rainbow (3.1.1)
223222
rake (13.0.6)
224-
reek (6.1.0)
225-
kwalify (~> 0.7.0)
226-
parser (~> 3.1.0)
227-
rainbow (>= 2.0, < 4.0)
228223
regexp_parser (2.2.1)
229224
rexml (3.2.5)
230225
rubocop (1.26.0)
@@ -303,7 +298,6 @@ DEPENDENCIES
303298
pundit
304299
rack-cors
305300
rails (~> 7.0.2, >= 7.0.2.3)
306-
reek (~> 6.1.0)
307301
rubocop-github
308302
rubocop-performance
309303
rubocop-rails

README.md

+51-13
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,62 @@
1-
# README
1+
## Next.js + Ruby on Rails API
22

3-
This README would normally document whatever steps are necessary to get the
4-
application up and running.
3+
Next.js on Rails is an optionated template for quickly setting up a project with Next.js as the frontend and Ruby on Rails as the backend API.
54

6-
Things you may want to cover:
5+
It follows the best practices of [Next.js](https://nextjs.org/docs/getting-started/introduction) and [Ruby on Rails](https://rubyonrails.org/). It is actively maintained and is a great starting point for new projects.
76

8-
* Ruby version
7+
We have added Docker support to this template. You can find the Dockerfile in the `docker` directory. <br><br>
98

10-
* System dependencies
9+
*For a quick start, you can run the following command:*
1110

12-
* Configuration
11+
```bash
12+
docker-compse up
13+
```
1314

14-
* Database creation
15+
## Features:
16+
#### Backend
17+
- User Authentication using JWT
18+
- User Authorization using Pundit
19+
- Interactor Pattern for API using interactor gem
20+
- premailer-rails for styling emails with stylesheets
21+
- pagy for faster pagination
22+
- jb for a fast JSON API builder
23+
- MiniTest for testing
24+
- SimpleCov for code coverage
1525

16-
* Database initialization
26+
### Frontend
27+
- User Signup and Login
28+
- User Profile
29+
- All basic components under `components/shared`
1730

18-
* How to run the test suite
1931

20-
* Services (job queues, cache servers, search engines, etc.)
32+
## Setup instructions
2133

22-
* Deployment instructions
34+
### Manual
35+
- Ruby 3.0.3
36+
- Node >= 14.x.x
2337

24-
* ...
38+
```bash
39+
# run in the root directory
40+
$ bundle install
41+
42+
# create database, migrate & seed
43+
$ rails db:prepare
44+
45+
# install packages and come back to root directory
46+
$ cd frontend && npm install && cd ..
47+
48+
# run the application using Foreman
49+
# services are defined in the Procfile
50+
$ foreman start
51+
```
52+
53+
### Docker
54+
```bash
55+
$ docker-compose up
56+
```
57+
58+
59+
## Contribution
60+
Contribution is welcome! It can be as simple as fixing a typo.
61+
<br><br>
62+
If you're facing any difficulty, create issues in the github repo and I will be happy to help.

entrypoint.sh

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,5 @@ if [ -e tmp/pids/server.pid ]; then
88
rm tmp/pids/server.pid
99
fi
1010

11-
# Then exec the container's main process (what's set as CMD in the Dockerfile).
11+
# exec the container's main process (what's set as CMD in the Dockerfile).
1212
exec "$@"

0 commit comments

Comments
 (0)