Floppy

A GitHub Action to share build artifacts as links on your pull request

Reviewers open your build's PDFs, screenshots and exports straight from the pull request, in a browser. To share build artifacts as links, add the l23c/floppy-action GitHub Action to your workflow. The action uploads the files to Floppy (fpy.sh), comments one short link per file on the pull request, and shows who opened each.

fpy.sh/changelog/github-action-to-share-build-files · Updated 14 November 2026 · This page as Markdown

How do I share build artifacts as links on a pull request?

Add one step after your build.

  1. Sign in at fpy.sh/app/keys and create a key with write access.
  2. In your repository, open Settings → Secrets and variables → Actions and add the key as FLOPPY_API_KEY.
  3. Give the job pull-requests: write and add the step:
on: pull_request
permissions:
  contents: read
  pull-requests: write
jobs:
  share:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - run: make report.pdf
      - uses: l23c/floppy-action@v1
        with:
          path: report.pdf
          api-key: ${{ secrets.FLOPPY_API_KEY }}

The action is on the GitHub Marketplace as Floppy file share. Source and full reference: github.com/l23c/floppy-action.

What does the pull request comment look like?

One comment per workflow job lists each file with its link. Later runs edit that comment instead of posting a new one.

2 files on Floppy for 3f9c2e1

- report.pdf → https://fpy.sh/k3x9
- screenshot.png → https://fpy.sh/m2p8

The job summary lists every link with its malware scan state and expiry. Your key and any claim link are masked in the logs.

Which inputs and outputs does the action have?

path is the only required input.

InputWhat it does
pathA file, directory or glob, one per line. A line starting with ! excludes matches.
api-keyYour Floppy key from a secret, so files land in your account.
labelMakes a per-recipient link, such as Design review, so its views are counted apart.
expiry1D, 2D, 3D, 5D, 1W, 2W, 1M, 3M or NEVER.
commentauto (default) comments on pull request events. false turns it off.
if-no-files-founderror (default), warn or ignore.

The action has four outputs:

  • url: the first link.
  • urls: all links, as JSON.
  • links: name, url, id, scan and expiry for each file.
  • claim-url: set when there was no key.

Can I try the action without a Floppy account?

Yes. Leave out api-key and the first upload creates an unclaimed Floppy account for the run.

  • Links work for 72 hours, then the files are deleted.
  • Safe file types only: PDF, Markdown and text, images, audio, video, CSV and JSON.
  • Up to 20 links and 1 GB.
  • The claim-url output moves everything into a Floppy account. It is never put in the comment.

Pull requests from forks can't read your secrets, so they upload this way.

For AI agents

Outside GitHub Actions, an agent or a script makes the same upload:

  • curl -T report.pdf https://fpy.sh/api/drop/report.pdf -H "Authorization: Bearer $FLOPPY_API_KEY": uploads up to 100 MB to your account and returns the link.
  • upload_file (MCP): the same upload from an agent.
  • get_link_analytics (MCP): who opened the file.

Setup for every agent is in the agent docs.

Questions people ask

Is the Floppy GitHub Action free?

Yes. The action is open source (MIT) and uses your Floppy plan. Free has 2 GB of storage and files up to 500 MB. Pro is €12/mo for 250 GB and files up to 50 GB.

Does the reviewer need a Floppy account to open the link?

No. Anyone with the link opens the file in a browser, on a phone or a computer.

Can I use the action on releases or pushes to main?

Yes. The action runs on any event. By default it comments only on pull request events, and the url and urls outputs give you the links for a later step.

Can the action upload files bigger than 100 MB?

Yes. Files over 100 MB go up in 32 MiB parts, retried on errors, up to your plan's per-file limit.

What shipped in v1.7.0

  • l23c/floppy-action uploads files from a GitHub workflow and comments the share links on the pull request
  • The action works with an API key from a repository secret, or without an account for 72 hours, and handles files over 100 MB

See it in the changelog

Related

Continue with GoogleFree to start. No account needed to open a link.