# alfred-config

> Allow easy user configurations for your Alfred workflows

Latest version **0.2.3** (published 2021-08-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install alfred-config
pnpm add alfred-config
yarn add alfred-config
bun add alfred-config
```

Provides the command `alfred-config`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.3 |
| Published | 2021-08-07 |
| First published | 2019-07-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=8 |
| Dependencies | 9 |
| Unpacked size | 7.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 40 |
| Author | Sam Verschueren |
| Maintainers | samverschueren |
| Keywords | alfy, alfred, config, user, configuration, conf, workflow, workflows |

## Links

- npm: https://www.npmjs.com/package/alfred-config
- Repository: https://github.com/SamVerschueren/alfred-config
- Homepage: https://github.com/SamVerschueren/alfred-config#readme
- Issues: https://github.com/SamVerschueren/alfred-config/issues
- npm.io page: https://npm.io/package/alfred-config

## Dependencies (9)

- [execa](https://npm.io/package/execa.md) ^5.1.1
- [hjson](https://npm.io/package/hjson.md) ^3.2.2
- [plist](https://npm.io/package/plist.md) ^3.0.2
- [mkdirp](https://npm.io/package/mkdirp.md) ^1.0.4
- [dot-prop](https://npm.io/package/dot-prop.md) ^6.0.1
- [open-editor](https://npm.io/package/open-editor.md) ^3.0.0
- [path-exists](https://npm.io/package/path-exists.md) ^4.0.0
- [is-plain-obj](https://npm.io/package/is-plain-obj.md) ^3.0.0
- [resolve-alfred-prefs](https://npm.io/package/resolve-alfred-prefs.md) ^2.0.0

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 0.2.3 (latest) — 2021-08-07
- 0.2.2 — 2021-06-04
- 0.2.1 — 2019-09-16
- 0.2.0 — 2019-09-16
- 0.1.1 — 2019-07-25
- 0.1.0 — 2019-07-25

## README

# alfred-config ![Build Status](https://github.com/SamVerschueren/alfred-config/workflows/CI/badge.svg)

> Allow easy user configurations for your [Alfred](https://www.alfredapp.com/) workflows


## Install

```
$ npm install --save alfred-config
```


## Usage

Add the `alfred-config` command as `postinstall` script of your Alfred package.

```json
{
	"name": "alfred-unicorn",
	"scripts": {
		"postinstall": "alfred-config"
	}
}
```

After installing the `alfred-unicorn` package, the system will open the text editor and allows your user to change the provided workflow configuration.

### Workflow configuration

A workflow configuration is defined by a JSON file which allows comments.

```js
{
	// GitHub API key
	"apiKey": "",

	// Throttling rate (requests per second)
	"throttling": 50,

	// GitHub user information
	"user": {
		"name": "",
		"email": ""
	}
}
```

You can provide defaults as well which the user can change after installing the package.

When your workflow evolves over time, you can add more properties or even remove deprecated ones. It will automatically merge the old user provided configuration with the new workflow configuration, removing unused properties.


## Related

- [alfy](https://github.com/sindresorhus/alfy) - Create Alfred workflows with ease


## License

MIT © [Sam Verschueren](https://github.com/SamVerschueren)

---
_Source: https://npm.io/package/alfred-config · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._