# cloudflare/miniflare

🔥 Fully-local simulator for Cloudflare Workers. For the latest version, see https://github.com/cloudflare/workers-sdk/tree/main/packages/miniflare.

Repository: https://github.com/cloudflare/miniflare
Canonical: https://ross.abutalabs.com/products/miniflare
Homepage: https://miniflare.dev
Language: TypeScript
License: MIT
License Family: permissive
Topics: cloudflare, cloudflare-workers
Archived: true
Last push: 2025-03-13T11:28:31+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 11, release rhythm 8, longevity 100
- inputs: {"age_days": 1931, "days_push": 538, "days_rel": 695, "gap_med": null, "n_releases_24m": 1}
- flags: archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3924, forks 209 (observed 2026-08-28T04:08:29.830534+00:00)

## What it is
Miniflare is a fully-local simulator for Cloudflare Workers written in TypeScript, running worker code in a sandbox that implements the Workers runtime APIs. It supports most Workers features including KV, Durable Objects, R2, D1, and WebSockets, and is now maintained as part of the workers-sdk monorepo.

## Use cases
- develop and test Cloudflare Workers locally without internet
- run integration tests against Workers bindings like KV and Durable Objects
- simulate Workers runtime APIs offline
- hot-reload Worker code during local development
- test D1, R2, and KV storage locally before deploying
- build custom local dev tooling on top of the Workers runtime

## When to choose
- you need a fully offline local environment for Cloudflare Workers
- you want to write automated integration tests for Workers
- you need programmatic control over the Workers runtime sandbox
- you're building tooling that embeds a Workers-like runtime

## When to avoid
- you just want standard local development - use Wrangler instead
- you need exact production parity for edge behaviors not covered by the simulator
- you're not developing Cloudflare Workers at all

## Facets
- artifact type: library
- maturity: active
- function: testing, http-server, developer-tools, simulation
- domain: developer-tools, web-development, backend, testing
- platform: cross-platform, cli
- tags: cloudflare-workers, local-development, serverless, kv, durable-objects, r2, d1, wrangler, nodejs

## Member repositories
- cloudflare/miniflare (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:29.830534+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:24:44.799908+00:00, confidence not recorded.
  - readme: https://github.com/cloudflare/miniflare (fetched 2026-08-28T04:08:29.830534+00:00, sha 0a38fa706f01)
  - homepage: https://miniflare.dev (fetched 2026-08-29T09:19:07.177765+00:00, sha cc98d72909d9)
  - site_page: https://developers.cloudflare.com/workers/get-started/quickstarts (fetched 2026-08-29T09:19:07.190610+00:00, sha d87982daf15a)
  - site_page: https://developers.cloudflare.com/ (fetched 2026-08-29T09:19:07.186526+00:00, sha 1b8430a97c92)
  - site_page: https://developers.cloudflare.com/changelog (fetched 2026-08-29T09:19:07.188487+00:00, sha d22a1e616fbf)
  - site_page: https://developers.cloudflare.com/workers/configuration/integrations (fetched 2026-08-29T09:19:07.192130+00:00, sha 3eba5356cf69)
  - site_page: https://developers.cloudflare.com/workers/configuration/integrations/apis (fetched 2026-08-29T09:19:07.193644+00:00, sha cf5efbbb96c4)
  - site_page: https://developers.cloudflare.com/workers/configuration/integrations/external-services (fetched 2026-08-29T09:19:07.195170+00:00, sha da9f2b99b2fb)
  - site_page: https://developers.cloudflare.com/workers/ci-cd/builds/limits-and-pricing (fetched 2026-08-29T09:19:07.196771+00:00, sha 0eea4797aa81)
  - site_page: https://developers.cloudflare.com/secrets-store/integrations/workers (fetched 2026-08-29T09:19:07.198307+00:00, sha 3413f45988ee)
- Data as of 2026-08-30T08:39:29.467469+00:00.