Usage

Contribute

Regardless of the platform you are working on, you will need to have Yarn installed. If you have never installed Yarn before, you can find out how at: https://yarnpkg.com/en/docs/install.

1. Install necessary packages:

• Windows
  • Be sure to run yarn global add windows-build-tools to install windows-build-tools.
• macOS
  • Once you have installed Yarn, you can skip this section!
• Linux(You can see here what your Linux is based on.)
  • RPM-based
    • GraphicsMagick
    • libicns-utils
    • xz (Installed by default on some distributions.)
  • Debian-based
    • graphicsmagick
    • icnsutils
    • xz-utils

2. Fork this repository to your own GitHub account and then clone it to your local device
3. Install the dependencies: yarn
4. Build the code and watch for changes: yarn run dev
5. To run pc

• yarn run app from another terminal tab/window/pane
• If you are using Visual Studio Code, select Launch pc in debugger configuration to launch a new pc instance with debugger attached.

To make sure that your code works in the finished application, you can generate the binaries like this:

yarn run dist

After that, you will see the binary in the ./dist folder!

Known issues that can happen during development

Error building node-pty

If after building during development you get an alert dialog related to node-pty issues, make sure its build process is working correctly by running yarn run rebuild-node-pty.

If you are on macOS, this typically is related to Xcode issues (like not having agreed to the Terms of Service by running sudo xcodebuild after a fresh Xcode installation).

Error with codesign on macOS when running yarn run dist

If you have issues in the codesign step when running yarn run dist on macOS, you can temporarily disable code signing locally by setting export CSC_IDENTITY_AUTO_DISCOVERY=false for the current terminal session.