Context
The upload-action currently lives at upload-action/ inside the filecoin-pin monorepo and is versioned alongside the CLI and library. Now that we are treating it as the authoritative GitHub Action for uploading to Filecoin — IP Shipyard is not taking on this work in ipfs-deploy-action (see ipshipyard/ipfs-deploy-action#39) — it needs to be independently releasable.
Per discussions with Rod (2026-05-26): extract into its own repo to avoid version lockstep between the npm package and the action, and to get cleaner issue tracking separation.
Why
- Decouple release cadence. A docs-only or action-logic change shouldn't require a full filecoin-pin release, and a library release shouldn't force action consumers to update.
- Follow GitHub Actions conventions. Actions are typically pinned with
@v1 / @v1.2.3 on the action's own repo. Today consumers use filecoin-project/filecoin-pin/upload-action@v0 (subdirectory action in a monorepo), which works but is non-standard.
- Independent issue tracking. Action-specific issues and PRs won't be interleaved with CLI/library work.
- Future flexibility. A standalone action repo opens the door for independent evolution including potential monetization opportunities.
Proposed plan
Pre-requisites
Related
Context
The upload-action currently lives at
upload-action/inside the filecoin-pin monorepo and is versioned alongside the CLI and library. Now that we are treating it as the authoritative GitHub Action for uploading to Filecoin — IP Shipyard is not taking on this work in ipfs-deploy-action (see ipshipyard/ipfs-deploy-action#39) — it needs to be independently releasable.Per discussions with Rod (2026-05-26): extract into its own repo to avoid version lockstep between the npm package and the action, and to get cleaner issue tracking separation.
Why
@v1/@v1.2.3on the action's own repo. Today consumers usefilecoin-project/filecoin-pin/upload-action@v0(subdirectory action in a monorepo), which works but is non-standard.Proposed plan
filecoin-project/filecoin-pin-upload-action(or similar) repoupload-action/contents (action.yml, src/, examples/, FLOW.md) to the new repofilecoin-pinfrom npm (already the case — the action runsnpx filecoin-pinunder the hood)v1for GA)upload-action/in the monorepo for a transition periodPre-requisites
Related