https://github.com/avivbens/fast-alfred

Your Alfred friendly framework, for developing Alfred workflows in TypeScript/JavaScript 🥷
https://github.com/avivbens/fast-alfred

alfred alfred-5 ci-cd javascript macos nodejs typescript workflow

Last synced: 2 months ago
JSON representation

Your Alfred friendly framework, for developing Alfred workflows in TypeScript/JavaScript 🥷

• Host: GitHub
• URL: https://github.com/avivbens/fast-alfred
• Owner: Avivbens
• License: mit
• Created: 2024-06-01T00:12:22.000Z (12 months ago)
• Default Branch: master
• Last Pushed: 2025-02-19T14:24:04.000Z (3 months ago)
• Last Synced: 2025-03-17T19:38:39.576Z (2 months ago)
• Topics: alfred, alfred-5, ci-cd, javascript, macos, nodejs, typescript, workflow
• Language: TypeScript
• Homepage: https://avivbens.github.io/fast-alfred/
• Size: 2.76 MB
• Stars: 13
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md

Awesome Lists containing this project

README

        


# Build Amazing Alfred Workflows! :ninja:

**`fast-alfred` - Your Alfred friendly framework**, for developing Alfred workflows in TypeScript/JavaScript.




[![npm](https://img.shields.io/npm/v/fast-alfred)](https://www.npmjs.com/package/fast-alfred)

[![npm](https://img.shields.io/npm/dt/fast-alfred)](https://www.npmjs.com/package/fast-alfred)

![GitHub](https://img.shields.io/github/license/avivbens/fast-alfred)

[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/kcao7snkgx)

### Read Our Official Docs 📚



## Installation

```bash

npm install fast-alfred

```

# The Reason

`fast-alfred` lets you think about the functionality, rather than the boilerplate.

It provides you with a convenient way to manage your workflow, apply proper versioning, and bundle it into a `.alfredworkflow` file.

## The Hard Time When Developing Alfred Workflows In Node.js

According to [Alfred's official community](https://www.alfredforum.com/topic/21366-nodejs-workflows-deployment/?do=findComment&comment=110924),

it is not a best-practice to include any external dependencies at installation time,

so all of your code and its dependencies should be included in the workflow file.

[Alfred Gallery](https://alfred.app/) requires you to upload a `.alfredworkflow` file, which is a zip archive containing all the necessary files for your workflow to run.

In order to accomplish this task, we need to bundle our code into a single file and include it in the workflow.

## The Solution

`fast-alfred` allows you to bundle your production code into a few scripts, and include them in the workflow.

All bundle options are configurable, via a `.fast-alfred.config.cjs` file at the root of your project.