Cloudflare-native remote cache for Turborepo. Worker hot path. R2-backed artifacts. Self-hostable.
Docs: https://turboflare.vaishnav.one/
Turboflare is alpha software. Expect breaking changes while it hardens. Do not treat it as a stable Cloudflare product.
Interested? DM @wishee0. Bugs and feature requests: GitHub Issues.
- Implements Turbo remote cache routes under
/v8/artifacts. - Stores artifacts in R2 by default.
- Supports static bearer tokens, scoped tokens, and optional D1-backed tokens.
- Supports
/v2Turbo identity compatibility. - Includes optional branch policies, signature enforcement, cleanup, Cache API reads, Analytics Engine metrics, and Rate Limiting.
Clone-free guided setup:
pnpm dlx create-turboflareManual setup: deploy with the button above or from a source checkout, then set a Worker secret named TURBO_TOKEN.
wrangler secret put TURBO_TOKEN --config apps/cache-worker/wrangler.jsoncPoint Turbo at the Worker:
export TURBO_API="https://<worker-name>.<subdomain>.workers.dev"
export TURBO_TOKEN="<same token>"
export TURBO_TEAM="team-name"
turbo run build --cache=local:,remote:w
rm -rf .turbo
turbo run build --cache=local:,remote:rThe second run should report a remote cache hit.
Manual deploy:
pnpm install
pnpm deploy
wrangler secret put TURBO_TOKEN --config apps/cache-worker/wrangler.jsoncpnpm setup is the guided source-checkout setup for contributors or customized deploys.
- Docs: https://turboflare.vaishnav.one/
- Getting started: https://turboflare.vaishnav.one/guide/getting-started/
- Feature matrix: https://turboflare.vaishnav.one/guide/features/
- Issues: https://github.com/vaishnav-mk/turboflare/issues
pnpm install
pnpm check
pnpm --filter @turboflare/cache-worker devUseful commands:
| Command | Purpose |
|---|---|
pnpm check |
full local verification |
pnpm test |
unit tests |
pnpm test:integration |
real Turbo fixture against Worker handler |
pnpm build |
Worker dry-run bundle + docs build |
pnpm docs:dev |
run docs locally |
pnpm r2:lifecycle:dry-run |
print R2 lifecycle payload |