@joshfarrant/shortcuts-js0.5.0 • Public • Published
A Node.js iOS 12 Shortcuts creator.
Find out more at Shortcuts.fun.
@joshfarrant/shortcuts-js on npm.
See this issue for a complete list of all Actions implemented so far.
We have a Discord! If you need any help or have any questions, come and say hi! Join the Discord
Is the Action you want not available?
We're still working our way through the long list of built-in Shortcut Actions, if there's one you need sooner rather than later then Open an Issue and let us know; we might be able to prioritise it.
Alternatively, it's super easy to add an Action yourself! A simple Action should only take about 15 minutes to implement. Check out the Contributing Guide for more info on where to start. If for any reason you get stuck just Open an Issue. We're happy to help!
npm install @joshfarrant/shortcuts-js
// Only used to create the .shortcut fileconst fs = ;constactionOutputbuildShortcutwithVariables= ;constcalculatecommentnumbershowResult} = ;// We'll use this later to reference the output of a calculationconst calcVar = ;// Define our list of actionsconst actions =;// Generate the Shortcut dataconst shortcut = ;// Write the Shortcut to a file in the current directoryfs;
Running this code will build a Shortcut named 'My Fancy Shortcut.shortcut' in the current directory.
This can be AirDropped to an iPhone or iPad running iOS 12, at which point it will be automatically opened and imported into Shortcuts.
For brevity, these examples omit the code for writing the file to disk and just focus on building the Shortcut. See the Minimal Example above for an example of how to create the .shortcut file.
Battery level checker, with conditional action
constactionOutputbuildShortcutwithVariables= ;constconditionalgetBatteryLevelsetLowPowerModeshowResult= ;const batteryLevel = ;const actions =;const shortcut = ;
Shortcut folder creator
This example creates folders and subfolders of Shortcuts so they can be easily run from one 'Folder' Shortcut.
This Shortcut could be tedious to set up using the drag-and-drop interface of the Shortcuts app, however we can simplify the generation of this Shortcut by using a function to build our actions from a predefined array of strings.
constbuildShortcutwithVariables= ;constconditionalgetBatteryLevelsetLowPowerModeshowResult= ;const foldersArr ='Health' // The name of the folder'Log Sleep' // The names of Shortcuts to contain in that folder'Log Run''Log Cycle''Home''Lights''Lights On' // We can go as many levels deep as we like'Lights Off''Heating''Heating On''Heating Off''Cameras''Cameras On''Cameras Off''Door''Lock Door''Unlock Door''Audio''Play Playlist''Resume Podcast';const buildFolders =arr;const actions =;const shortcut = ;
If you're having any issues getting started, or you'd just like some advice, then please don't be afraid to Open an Issue, we're here to help!