actionsflow

Actionsflow

---

The best IFTTT/Zapier free alternative for developers to automate your workflows based on Github actions

📝 Table of Contents

• About
• Document
• How Actionsflow Worked
• Getting Started
• Contributing
• Authors

🧐 About

Actionsflow helps you to automate workflows, it's the best IFTTT/Zapier free alternative for developers. With Actionsflow, you can connect your favorite apps, data, and APIs, receive notifications of actions as they occur, sync files, collect data, and more. , We implemented it based on Github actions, and you use a YAML file (The configuration format is the same as Github actions) to build your workflows. If you have already written a Github actions file, it's very easy to define an Actionsflow workflow file, and you can use any Github actions as your job's steps.

You can see core concepts of Actionsflow at here.

🔥 Features

• Totally Free! Actionsflow based on Github actions. To run an Actionsflow workflow, you just need to create a repository from Actionsflow template repository.
• support almost all actions of github, you can use almost all Github actions. Actionsflow use act for running Github actions. With Github actions, You can connect with IFTTT, Zapier, or the other services.
• Easy to write workflow file, the Actionsflow configuration format is the same as Github actions, If you have already written a Github actions file, it's very easy to define an Actionsflow workflow file,
• Run a trigger every 5 minutes. The workflow can check and run every 5 minutes based on Github actions scheduled events

🎓 Document

Full documentation for Actionsflow lives on the website.

You can also view it at Github if you prefer.

If you need actionsflow npm package docs, please see here

👀 How Actionsflow worked

Actionsflow setup a Github scheduled action with running every 5 minutes, Actionsflow will check if there are any updates with the triggers in the workflows, if Actionsflow found an updated item, it will generate a standard Github actions workflow file with the item payload, and call act to run the built workflow.

🏁 Getting Started

Build an Actionsflow workflows is basically a three-step process:

1. Create a public Github repository by this link
2. Define your workflow files at workflows directory, you can find some workflow file examples at here
3. commit and push your updates to Github

Then, Actionsflow will run your workflows as you defined, you can view logs at your repository actions tab at Github

For more information about quick started, see Getting Started

Structure

A typical Actionsflow repository structure looks like this:

.
├── .github
│   └── workflows
│       └── actionsflow-jobs.yml
├── .gitignore
├── README.md
└── workflows
    └── rss2ifttt.yml
    └── webhook2ifttt.yml

Take a look with the Actionsflow official template repository

Workflow File

A typical workflow file xxx.yml looks like this:

on:
  rss:
    event: new_item
    url: https://hnrss.org/newest?points=300
jobs:
  ifttt:
    name: Make a Request to IFTTT
    runs-on: ubuntu-latest
    steps:
      - uses: actionsflow/ifttt-webhook-action@v1
        with:
          event: notice
          key: ${{ secrets.IFTTT_KEY }}
          value1: ${{on.rss.outputs.title}}
          value2: ${{on.rss.outputs.contentSnippet}}
          value3: ${{on.rss.outputs.link}}

For more information about the Actionsflow workflow file, see the Actionsflow workflow reference.

For more information about the Actionsflow triggers, see Triggers

For more information about use cases, see Examples.

For more questions about Actionsflow, see FAQs

🤝 How to Contribute

Whether you're helping us fix bugs, improve the docs, or spread the word, we'd love to have you as part of the Actionsflow community! 💪💜

Check out our Contributing Guide for ideas on contributing and setup steps for getting our repositories up and running on your local machine.

✍️ Authors

• @theowenyoung - Idea & Initial work

See also the list of contributors who participated in this project.

📝 License

Licensed under the MIT License.