hidane

hidane (火種, the seed of fire) — a Firestore emulator without Java.

A single Rust binary that replaces the official Cloud Firestore emulator. No JVM. Starts in milliseconds. Tested for parity against the official emulator.

curl -fsSL https://hidane.dev/install.sh | sh Not yet available — Phase 0

Copy is disabled: there is nothing to install yet. This line becomes live with the first release.

Read why Star on GitHub

Phase 0 · research in progress · no release yet

Why hidane

0.74 s · 95 MiB

0.74 s to start, 95 MiB idle

The official emulator takes 0.74 s to open its port (2.5 s through the CLI) and sits at 95 MiB idle. hidane targets under 100 ms and under 50 MiB.

Source: measurements and raw logs
11× slower

Writes slow down as data grows

With a listener attached, the official emulator's batch writes slow down in proportion to the number of documents: 11 times slower at 100k. hidane is designed so that a commit costs only what it changes.

Source: measurements and raw logs

Figures for the official emulator are measurements. Figures for hidane are targets, not results. Context: why hidane.

Works with

Status today: every client is planned. planned in progress supported
v0.1firebase-admin (Node)planned
v0.1@google-cloud/firestoreplanned
v0.1Goplanned
v0.1Pythonplanned
v0.1Javaplanned
v0.1iOSplanned
v0.1Androidplanned
v0.1Flutter (mobile / desktop)planned
v0.1firebase-js-sdk on Nodeplanned
v0.2Security Rulesplanned
v0.3Browser firebase-js-sdkplanned
v0.3Flutter Webplanned

Which transport each SDK needs, and why the browser waits for v0.3: compatibility.

Parity

hidane treats the official emulator as the oracle: the same test suites run against both, and the results are published as a parity table. No claim of compatibility without a test behind it.

Parity results will appear here after v0.1.

Known, intentional differences are listed in parity exceptions.

Roadmap

  1. v0.1

    Server SDKs and native clients: firebase-admin, the Google Cloud libraries, iOS, Android and Flutter, running under firebase-tools.

    v0.1 milestone on GitHub
  2. v0.2

    Security Rules.

    v0.2 milestone on GitHub
  3. v0.3

    Browser clients: firebase-js-sdk in the browser and Flutter Web.

    v0.3 milestone on GitHub

Scope, targets and risks: ROADMAP.

Install (planned)

None of these channels exist yet. The commands below show the intended shape and do not work today.

GitHub ReleasesPrebuilt binariesplanned
cargo binstallcargo binstall hidaneplanned
Homebrew tapbrew install hidane-dev/tap/hidaneplanned
npmnpm install --save-dev hidaneplanned
pub.devdart pub global activate hidaneplanned
Dockerdocker run ghcr.io/hidane-dev/hidaneplanned
curl | shcurl -fsSL https://hidane.dev/install.sh | shplanned