Alfred 3 Workflow NodeJS Next library

Overview

A small library providing helpers to create Alfred Workflow. This is a forked version of https://github.com/giangvo/alfred-workflow-nodejs. This forked one is converted to ES6 and is simplified some APIs so this forked one is not completely compatible with original one. Because alfred-workflow-nodejs-next returns JSON format to Alfred so this is compatible with Alfred 3 or above only.

Installation

• Use yarn: yarn add alfred-workflow-nodejs-next
• Use npm: npm install --save alfred-workflow-nodejs-next

If you have any issue with yarn or npm, run yarn run clean to remove all packages in node_modules folder.

Tests

# running test
yarn test

# or running test in watch mode when developing
yarn test-watch

# running test with reporting coverage
yarn test-coverage

Docs

• docs/Workflow & Item - Build and generate Alfred workflow feedback
• docs/Utilities - Helper to filter arrays, run applesripts, etc...
• docs/Storage - Helper to CRUD temporary / permanent(settings) data.

Sample workflow using this library.

• alfred-workflow-go-links
• alfred-workflow-yarn-api-search
• alfred-workflow-immutablejs-api-search
• TODO: add more

Notice: docs/import-workflow-source-to-alfred.md - to show how to import workflow source code into Alfred.

Notes/Tips

• You can look at some tests in test folder in source code get more about usage.
• You can use console.trace('==========================', data) or console.warn('==========================', data) to debug code. DO NOT use console.log because it is used to return JSON string data to Alfred.
• Open "Toggle Debugging Mode" of Alfred to see all logs when developing.