https://github.com/kenforthewin/react-rails-auth

full-stack, dockerized React token authentication with a Rails api
https://github.com/kenforthewin/react-rails-auth

authentication docker docker-compose rails-api rails5 react

Last synced: 9 days ago
JSON representation

full-stack, dockerized React token authentication with a Rails api

• Host: GitHub
• URL: https://github.com/kenforthewin/react-rails-auth
• Owner: kenforthewin
• Created: 2017-11-25T18:53:25.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2017-11-28T20:11:55.000Z (almost 7 years ago)
• Last Synced: 2024-10-29T14:15:23.622Z (18 days ago)
• Topics: authentication, docker, docker-compose, rails-api, rails5, react
• Language: Ruby
• Homepage:
• Size: 148 KB
• Stars: 8
• Watchers: 4
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# react-rails-auth

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

## Getting started

All services in this repo are containerized. To get started, first make sure docker and docker-compose are installed.

1. Clone the repo and navigate to its folder

1. Create your own `.env` file at the base of the project. Refer to the `.env.sample` file for what's needed.

1. Run the dev script with `./scripts/run-dev.sh`

1. Wait for the images to build. 

1. Eventually the dev server will be up at `localhost:3001`

## Production stack

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](https://github.com/jwilder/docker-gen) and nginx are used to proxy requests to either the api or the react site. Finally, a [docker-letsencrypt-nginx-proxy-companion](https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion) container is included to optionally allow both services SSL encryption through Let's Encrypt.