marcelvenegas/startwarwebpak

WebApp boilerplate with React and Cloud 9

Requirements:

• Make sure you are using node version 8

Install the packages:

$ npm install

Start coding!

Start the webpack server with live reload:

• $ npm run start for windows, mac, linux or Gitpod.
• $ npm run c9 for Cloud 9 Users.

Styles

You can update the styles/index.scss or create new .scss files inside styles/ and import them into your current scss or js files depending on your needs.

Components

Add more files into your ./src/js/components or styles folder as you need them and import them into your current files as needed.

Note (New changes): Components have been converted into functions to support the use of hooks:

• Instead of a class component, we're using a const function.
• Class constructor and state have been replaced by useState() hooks.
• componentDidMount() was replaced by useEffect({}, []) - It runs at mount thanks to the second parameter ([]).
• Actions and Store still work the same way.

// Previous
export class Demo extends React.Component {
	constructor(props) {
		super(props);
		
		this.state = getState('code here');
	}
}

// New
export const Demo = () => (
	const [state, setState] = getState('code here');
);

Views (Components)

Add more files into your ./src/js/views and import them in ./src/js/layout.jsx.

Context

This boilerplate comes with a centralized general Context API. The file ./src/js/store/flux.js has a base structure for the store, we encourage you to change it and adapt it to your needs.

React Context docs

The Provider is already set. You can use the Consumer to get the store and actions from the Context. Check /views/demo.jsx to see a demo.

Publish your website!

This boilerplate is 100% compatible with the free github pages hosting. To publish your website you need to push your code to your github repository and run the following command after:

$ npm run deploy

Note: You will need to configure github pages for the branch gh-pages