⚡️ Automate your Formspree deployment using the Formspree CLI with GitHub Actions.

Create a new file /.github/workflows/formspree.yml with the following:

name: Formspree Deployment

on:
  push:
    branches:
    - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@master
    - name: Deploy
      uses: formspree/cli-action@main
      with:
        deployKey: ${{ secrets.FORMSPREE_DEPLOY_KEY }}

To use the Formspree CLI, you need to create a CLI project.

Once you have created a project on the dashboard, you'll receive a deploy key. You'll want to add this to GitHub's secrets. In your repository, go to Settings -> Secrets and add your deploy key. GitHub encrypts this token, and it won't be printed in the logs, so even for a public repository it won't be accessible to the world.

We need to include the authentication information in the with block of the action. If you've named the secret, FORMSPREE_DEPLOY_KEY, it would look like:

jobs:
  deploy:
    steps:
      uses: formspree/cli-action@main
      with:
        deployKey: ${{ secrets.FORMSPREE_DEPLOY_KEY }}

If you are using the Formspree CLI, use our quick start guide. Once you're ready to push your site live, you might want to automatically deploy new forms as you change the project. Using this action, you can configure your site without ever leaving your terminal.

First, look at the GitHub Actions logs and see if there's an error. If you still can't find anything, open a ticket with our support team and we'd be happy to look into it.