rbkit-electron-client

Rbkit client rebuilt from ground up using Electron, React and Webpack.

Screenshot

TODO

Installation and Usage

TODO

Development

$ git clone https://github.com/code-mancers/rbkit-electron-client.git
$ cd rbkit-electron-redux
$ nmp install
$ npm start

Note: requires a node version >= 4 and an npm version >= 2.

DevTools

Toggle Chrome DevTools

OS X: Cmd Alt I or F12
Linux: Ctrl Shift I or F12
Windows: Ctrl Shift I or F12

See electron-debug for more information.

Toggle Redux DevTools

All platforms: Ctrl+H

See redux-devtools-dock-monitor for more information.

Externals

If you use any 3rd party libraries which can't be built with webpack, you must list them in your webpack.config.base.js：

externals: [
  // put your node 3rd party libraries which can't be built with webpack here (mysql, mongodb, and so on..)
]

You can find those lines in the file.

CSS Modules

This boilerplate out of the box is configured to use css-modules.

All .css file extensions will use css-modules unless it has .global.css.

If you need global styles, stylesheets with .global.css will not go through the css-modules loader. e.g. app.global.css

Package

$ npm run package

To package apps for all platforms:

$ npm run package-all

Options

--name, -n: Application name (default: ElectronReact)
--version, -v: Electron version (default: latest version)
--asar, -a: asar support (default: false)
--icon, -i: Application icon
--all: pack for all platforms

Use electron-packager to pack your app with --all options for darwin (osx), linux and win32 (windows) platform. After build, you will find them in release folder. Otherwise, you will only find one for your os.

test, tools, release folder and devDependencies in package.json will be ignored by default.

Default Ignore modules

We add some module's peerDependencies to ignore option as default for application size reduction.

babel-core is required by babel-loader and its size is ~19 MB
node-libs-browser is required by webpack and its size is ~3MB.

Note: If you want to use any above modules in runtime, for example: require('babel/register'), you should move them from devDependencies to dependencies.

Building windows apps from non-windows platforms

Please checkout Building windows apps from non-windows platforms.

How hot-reloading works on Electron

We use webpack-target-electron-renderer to provide a build target for electron renderer process. Read more information here.

Note: webpack >= 1.12.15 has built-in support for electron-main and electron-renderer targets.

Uses electron-react-boilerplate

How to keep the boilerplate updated

git remote add boilderplate https://github.com/chentsulin/electron-react-boilerplate.git

Then, use git to pull in latest stuff from the boilerplate

git pull boilerplate master

License

MIT

emilsoman/rbkit-electron-client