https://github.com/lubien/koa-react-redux-universal-boilerplate
[Unmaintained] A fullstack Koa + React + Redux Universal Boilerplate to speed up your development process.
https://github.com/lubien/koa-react-redux-universal-boilerplate
koa react redux server-side-rendering webpack
Last synced: 14 days ago
JSON representation
[Unmaintained] A fullstack Koa + React + Redux Universal Boilerplate to speed up your development process.
- Host: GitHub
- URL: https://github.com/lubien/koa-react-redux-universal-boilerplate
- Owner: lubien
- License: mit
- Created: 2016-05-17T18:51:00.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2016-06-03T12:56:48.000Z (almost 9 years ago)
- Last Synced: 2025-03-28T07:11:25.426Z (about 1 month ago)
- Topics: koa, react, redux, server-side-rendering, webpack
- Language: JavaScript
- Homepage: https://koa-react-boilerplate.herokuapp.com/
- Size: 155 KB
- Stars: 22
- Watchers: 2
- Forks: 3
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Koa React Redux Universal Boilerplate
A fullstack Koa + React + Redux Universal Boilerplate to speed up your development process.
At first was just a simple boilerplate for my next projects on [FreeCodeCamp](https://www.freecodecamp.com), but that escalated quickly.
## Features
* Koa 2 supporting `async-await` with Babel.
* Redux.
* React.
* React Router
* Universal rendering.
* Redux Devtools
* Dirty deeds done dirt cheap.
## Getting Started
Copy `.env.sample` to `.env` and edit as you need.
### Development
For development, you just need `MONGO_URL` and `GITHUB_CLIENT_(ID|SECRET)` env vars.
Run `npm run dev-server` and `npm run dev-client` in separate terminals so you'll the Koa and Webpack servers.
Dev-server uses `nodemon` to restart the server everytime you change some server stuff. Webpack does the same on the client, so no need to `F5` your life.
Now you can open `http://localhost:3000/`.
For a better experience, use [zalmoxisus/redux-devtools-extension](https://github.com/zalmoxisus/redux-devtools-extension#implementation) so you can see Redux's current state.
### Production
We are using `babel-node` and `webpack-dev-server` for development, but they are a no go for production. The solution was simple: build everything. We build our server into a `build/` folder and our client to `public/scripts/bundle.js`.
The build is made right after `npm install` so, let's say you use a PaaS like Heroku. After each commit the system will be rebuilt. Awesome ;)
Two important env vars you should look are `BASE_URL` and `SUPPORT_HTTPS`. `BASE_URL` uses the model `https://example.com` (no stripe at end). Why? Github auth callback needs your URL match exactly in both your server and in your app Github's config. `SUPPORT_HTTPS` is a bool value.
## License
[MIT](LICENSE.md)