bitbybit-b3/cf-pr-preview-action

cf-pr-preview-action is a GitHub Action that gives every pull request its own temporary, isolated preview environment on Cloudflare. When a pull request is opened, the action creates a dedicated Cloudflare Worker along with its own D1 database, KV store, and R2 bucket just for that PR, deploys the code to it, runs any database migrations, and posts a comment on the pull request with a link to the live preview. When the pull request is closed, all of that infrastructure is torn down automatically, so nothing is left running. Setting it up means adding a step to a GitHub Actions workflow file that triggers on pull request events such as opened, updated, reopened, and closed. The example configuration installs dependencies with a tool called Bun, then calls this action with a couple of naming inputs for the preview Worker and database, along with a Cloudflare API token and account ID passed in as secrets. From there, opening a pull request produces a working preview at a workers.dev address, with a comment on the PR that updates as the preview changes and disappears when the PR closes. The action also supports syncing data from an existing development environment into each preview, so a preview does not have to start from an empty database. Full documentation, including token permission scopes, the complete list of configuration inputs and outputs, and the data syncing guide, lives on a separate documentation site linked from the README rather than in the README itself. For anyone contributing to the action itself, the project is written in TypeScript, uses Bun for installing packages, type checking, and testing, and builds down to a single committed file that GitHub Actions actually runs, with continuous integration checking that this built file stays in sync with the source. The project is released under the MIT license, a permissive license that allows free use, modification, and distribution as long as the copyright notice is kept.