/kit

Script Kit. Automate Anything.

Primary LanguageTypeScriptMIT LicenseMIT

Script Kit App

https://scriptkit.com/

Join the Discussion

https://github.com/johnlindquist/kit/discussions

Project Board

https://github.com/users/johnlindquist/projects/1/views/1?layout=board

Script Kit Dev Setup

Note: This ain't pretty 😅

Requirements: yarn 1

Why both npm and yarn?

The App was created with https://github.com/electron-react-boilerplate/electron-react-boilerplate a long time ago. They require yarn and webpack.

I have been unable to prioritize the time to switch over to another build system or keeping up with the boilerplate, especially with so many moving pieces.

Thus, we use yarn to build the App and npm to build the SDK 🤦‍♂️

Using node 16.17.1 from ~/.knode

Installing Kit.app already installed node 16.17.1 to ~/.knode. You'll want to use this node version for all build/run steps:

PATH=~/.knode/bin:$PATH

This will use 16.17.1's node/npm when working with Kit. (Alternatively, you can use nvm/n/whatever, but I don't)

  • Use volta to manage node versions.
    1. Install volta
    2. Volta will automatically switch node version to 16.17.1 when working with kit.

Clone Kit SDK

Clone: git clone https://github.com/johnlindquist/kit.git

Install: npm install

Clone Kit App

Clone: git clone https://github.com/johnlindquist/kitapp.git

Install: yarn

(Skip if you already have a kenv from production) Clone the base kenv

Clone: git clone https://github.com/johnlindquist/kenv.git ~/.kenv

Building Kit SDK

npm run build-kit

The build command builds the SDK to ~/.kit

yarn link (First run only)

  1. cd to ~/.kit
  2. yarn link
  3. cd to ~/wherever you cloned kitapp
  4. yarn link @johnlindquist/kit

This will force the App to use the SDK so you can work on both simultaneously

Building the App

yarn webpack-dev
yarn install-electron-deps
yarn start

Assuming everything went well, the app should start up.