Digital Paper Edit - Electron app

Electron Cross Platform Desktop app

---> Work in progress <--

For a ready to use release of the desktop application, checkout the user manual for more details on how to get started.

See here for overall project architecture info

Github project board (for my forks) - across linked repos

Setup

git clone [email protected]:bbc/digital-paper-edit-electron.git

cd digital-paper-edit-electron

Optional step to setup nvm to use node version 10, otherwise just use node version 10

nvm use || nvm install`

in root of project

npm install

Usage

npm start

System Architecture

Electron Cross platform desktop app

Development env

• npm > 6.1.0
• node v 10 - lts/dubnium
• see .eslintrc in the various packages for linting rules

Node version is set in node version manager .nvmrc

Build

TBC

Tests

TBC

Deployment

We use Github actions to build. And add new versions to github releases. Every time a new commit to master is pushed with a version tag.

1. Update the version in your project's package.json file (e.g. 1.2.3)
2. Commit that change (git commit -m"1.2.3" -m"optional message")
3. Tag your commit (git tag 1.2.3). Make sure your tag name's format is *.*.*.
   1. Your workflow will use this tag to detect when to create a release
4. Push your changes to GitHub (git push && git push origin v1.2.3)

Running a local electron build

However if you want to run a build and package the app locally you can use the npm scripts

Instructions for funning a local electron build

To build for mac, windows, and linux

npm run build:mwl

To build for mac only

npm run build:m

To build for windows only

npm run build:w

To build for linux only

npm run build:l

The build, packaged app will be in the /dist folder.