What it is
This repo contains a Ruby on Rails application serving as the api for a React frontend. The API backend serves user token-based authentication to a custom-rolled, redux-based authentication frontend. The token auth implementation aims to be as simple as possible while still maintaining full functionality.
Why it exists
Use this repo as a learning exercise for rolling your own token auth, or as a starting point for a new app.
All services in this repo are containerized. To get started, first make sure docker and docker-compose are installed.
- Clone the repo and navigate to its folder
- Create your own
.envfile at the base of the project. Refer to the
.env.samplefile for what's needed.
- Run the dev script with
- Wait for the images to build.
- Eventually the dev server will be up at
For production, the React site uses an alternate Dockerfile to build a production image. This image uses a simple nginx server to serve the static files which are generated from the build. Then, a combination of docker-gen and nginx are used to proxy requests to either the api or the react site. Finally, a docker-letsencrypt-nginx-proxy-companion container is included to optionally allow both services SSL encryption through Let's Encrypt.