kasia-boilerplate

A universal application boilerplate with Kasia

Made with ❤ at @outlandish

An easy way to start building universal/isomorphic JavaScript applications that talk to a WordPress backend. Right on!

What's inside?

We used the react-redux-universal-hot-example boilerplate as our starting point, however lots has changed since then and the two are now quite different. Thanks go to the creator and maintainers of the aforementioned repo.

// Tools/libraries/features
Express, stage-0 ES2015, React, React Router, Redux, Kasia, 
Redux Sagas, Redux Dev Tools, SCSS, Webpack, Hot Reloading

Getting Started

Set up WordPress

We aim to release an Ansible script which will do all of this for you, but for now...

Install wordpress at localhost/wordpress (or somewhere else; change accordingly in src/config.js)
Install and enable these plugins: WP API REST JSON API v2, WP API MENUS
Create two pages with slugs homepage and posts
Create a menu (Appearance > Menus) called 'primary' containing the two pages you just created
Create some Posts

Get the application

Clone this repo: git clone <url> wp-app
Change into it: cd wp-app
Install dependencies: npm install
Configure the application in src/config.js

Start the app

As a developer:

npm run build
npm run dev

By default the web server is at localhost:3000

______

In production:

npm run build
npm start

By default the web server is at localhost:8080

Contributing

All pull requests and issues welcome!

When submitting an issue please provide adequate steps to reproduce the problem.
PRs must be made using the standard code style.

If you're not sure how to contribute, check out Kent C. Dodds' great video tutorials on egghead.io!

Author & License

kasia-boilerplate was created by Outlandish and is released under the MIT license.

outlandishideas/kasia-boilerplate