Skip to content

Commit

Permalink
Update readme docs to reflect package.json structure changes (#1896)
Browse files Browse the repository at this point in the history
  • Loading branch information
amilajack authored Oct 30, 2018
1 parent cf8f64d commit d23845d
Showing 1 changed file with 4 additions and 34 deletions.
38 changes: 4 additions & 34 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ First, clone the repo via git:
git clone --depth=1 https://github.com/electron-react-boilerplate/electron-react-boilerplate.git your-project-name
```

And then install dependencies with yarn.
And then install the dependencies with yarn.

```bash
$ cd your-project-name
Expand All @@ -79,13 +79,6 @@ Start the app in the `dev` environment. This starts the renderer process in [**h
$ yarn dev
```

Alternatively, you can run the renderer and main processes separately. This way, you can restart one process without waiting for the other. Run these two commands **simultaneously** in different console tabs:

```bash
$ yarn start-renderer-dev
$ yarn start-main-dev
```

If you don't need autofocus when your files was changed, then run `dev` with env `START_MINIMIZED=true`:

```bash
Expand All @@ -102,7 +95,7 @@ $ yarn package

To package apps for all platforms:

First, refer to [Multi Platform Build](https://www.electron.build/multi-platform-build) for dependencies.
First, refer to the [Multi Platform Build docs](https://www.electron.build/multi-platform-build) for dependencies.

Then,

Expand All @@ -113,7 +106,7 @@ $ yarn package-all
To package apps with options:

```bash
$ yarn package -- --[option]
$ yarn package --[option]
```

To run End-to-End Test
Expand All @@ -133,28 +126,6 @@ $ yarn test-e2e
DEBUG_PROD=true yarn package
```

## How to add modules to the project

You will need to add other modules to this boilerplate, depending on the requirements of your project. For example, you may want to add [node-postgres](https://github.com/brianc/node-postgres) to communicate with PostgreSQL database, or
[material-ui](http://www.material-ui.com/) to reuse react UI components.

⚠️ Please read the following section before installing any dependencies ⚠️

### Module Structure

This boilerplate uses a [two package.json structure](https://github.com/electron-userland/electron-builder/wiki/Two-package.json-Structure). This means, you will have two `package.json` files.

1. `./package.json` in the root of your project
1. `./app/package.json` inside `app` folder

### Which `package.json` file to use

**Rule of thumb** is: all modules go into `./package.json` except native modules, or modules with native dependencies or peer dependencies. Native modules, or packages with native dependencies should go into `./app/package.json`.

1. If the module is native to a platform (like node-postgres), it should be listed under `dependencies` in `./app/package.json`
2. If a module is `import`ed by another module, include it in `dependencies` in `./package.json`. See [this ESLint rule](https://github.com/benmosher/eslint-plugin-import/blob/master/docs/rules/no-extraneous-dependencies.md). Examples of such modules are `material-ui`, `redux-form`, and `moment`.
3. Otherwise, modules used for building, testing and debugging should be included in `devDependencies` in `./package.json`.

### Further Readings

See the wiki page, [Module Structure — Two package.json Structure](https://github.com/electron-react-boilerplate/electron-react-boilerplate/wiki/Module-Structure----Two-package.json-Structure) to understand what is native module, the rationale behind two package.json structure and more.
Expand All @@ -176,7 +147,7 @@ If you want to import global css libraries (like `bootstrap`), you can just writ
@import '~bootstrap/dist/css/bootstrap.css';
```

## Sass support
## SASS support

If you want to use Sass in your app, you only need to import `.sass` files instead of `.css` once:

Expand Down Expand Up @@ -213,7 +184,6 @@ git pull upstream master
- [C. T. Lin](https://github.com/chentsulin)
- [Jhen-Jie Hong](https://github.com/jhen0409)


## Backers

Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/electron-react-boilerplate#backer)]
Expand Down

0 comments on commit d23845d

Please sign in to comment.