pietrop / digital-paper-edit-electron

Work in progress - digital paper edit project - Electron, Cross Platform Desktop app - Mac, Windows, Linux
https://pietropassarelli.net/autoedit
Other
102 stars 17 forks source link

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 git@github.com: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

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.