Skip to content
forked from GordyD/3ree

An example universal JS application written with the 3REE stack, React + Redux + RethinkDB + Express. A stack for building apps, front and back end, with just Javascript.

Notifications You must be signed in to change notification settings

joelsamuelk/3ree

 
 

Repository files navigation

3REE

Circle CI

An example universal JS application written with the 3REE stack, React + Redux + RethinkDB + Express. A stack for building apps, front and back end, with just Javascript.

This project was initially conceived to experiment with using these technologies in conjunction with one-another. I have written a blog that relates to this codebase.

Screenshot

This project is useful for:

  • seeing how to build a Universal Javascript application
  • understanding how to handle asyncronousity in Redux action creators
  • seeing how you can use Socket.io with Redux
  • building your own Redux powered application
  • forking so that you can build your own 3REE stack app!

Main Features

  • Universal (Isomorphic) Javascript
  • Asyncronous Redux actions example
  • Use of RethinkDB Changefeeds for realtime updates reflected in the UI

Demo

There is a demo app hosted at 3ree-demo.workshape.io. Check it out. If it is down, please email me at [email protected]

Setup

You will need to install RethinkDB. You can find instruction on how to do so here.

  • Clone the repo git clone [email protected]:GordyD/3ree.git
  • Run npm install
  • If your local environment is not reflected by config/default.json, then add a file at config/local.json to provide local customisation.
  • Run npm run db-setup to set up DB

Running Dev Server

  • Run npm start will start Webpack dev server - for serving the client, and also start the API server
  • Go to http://localhost:3001 in two seperate tabs - see changes propagate in real time (Hot Module Replacement works too)

Running Production Server

You will need to roll out your own deployment script for a server, but before you can ship you will need to:

  • Build the client with npm run build:prod
  • Ensure all production npm modules are installed on the server. e.g. npm install --prod
  • Rsync your application to your server
  • Set up nginx or your web server of choice to map HTTP requests for your URL to http://localhost:3000
  • Run npm run start:prod to run on your server
  • Go to your URL

Tech Used

Tech Description Version
React View layer 0.14.7
React Router Universal routing 2.0.0
Redux State management 3.1.0
RethinkDB Persistance layer 2.2.4
Express Node.js server framework 4.13.3
Socket.io Used for realtime communication between clients and server 1.4.4
Webpack Module bundling + build for client 1.12.11
Superagent Universal http requests 1.6.1
Stylus Expressive, dynamic, robust CSS 0.53.0

About

An example universal JS application written with the 3REE stack, React + Redux + RethinkDB + Express. A stack for building apps, front and back end, with just Javascript.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 53.5%
  • CSS 46.5%