░█▀▀░█▀█░█▀▀░▀█▀░█▀█░█▀▄░█░░█░█
░█▀▀░█▀█░█░░░░█░░█░█░█▀▄░█░░░█░
░▀░░░▀░▀░▀▀▀░░▀░░▀▀▀░▀░▀░▀▀▀░▀░

Factorly Blueprints

A blueprint is a single YAML file that bundles tools, workflows, and OAuth provider definitions into one installable unit for Factorly. This repo is a community catalog of blueprints you can install directly.

Install a blueprint from this repo

Point factorly blueprint install at the YAML file in this repo using GitHub shorthand:

factorly blueprint install github.com/factorly-dev/factorly-blueprints/example/gmail.yaml

Pin a tag, branch, or commit:

factorly blueprint install github.com/factorly-dev/factorly-blueprints@v1.0.0/example/gmail.yaml

The install flow validates the YAML, prompts for any required vault keys (API tokens, OAuth client IDs/secrets), and writes the blueprint to .factorly/blueprints/<name>.yaml. For OAuth blueprints like Gmail, follow up with factorly auth login <name> to complete the consent flow.

Learn more

• Full blueprints documentation — bundled blueprints, authoring your own, OAuth setup, oversight rules, CLI reference
• Factorly — the main repo

License

Blueprints in this repo are licensed under the MIT license, separately from factorly.