Skip to content
nimbus

Firestore example apps

Runnable Firestore apps that build on Nimbus with stock firebase/app and firebase/firestore imports. Unary calls go over REST or gRPC-Web, and live queries use Nimbus’s WebSocket Listen bridge. Read the overview first if you have not pointed a Firestore app at Nimbus yet.

The apps live under examples/firebase/ in the source repository. Run them in place from a checkout — each imports the repository’s workspace packages.

Run any example

Section titled “Run any example”
Terminal window
nimbus dev

nimbus dev starts a local server with the Firestore-compatible routes. The Firestore project id is demo, which maps to the same-named Nimbus tenant. These apps are Firestore clients (a browser UI plus a support server) with no Nimbus function bundle to deploy, so there is no nimbus deploy step. Each app also has standalone firebase:server:* (the support server) and firebase:example:* (the Vite dev server) npm scripts, listed in its README — run them in place from a checkout.

The apps

Section titled “The apps”
  • Browser (html) — a browser playground served by the Nimbus-provisioned firebase package. It exercises connectFirestoreEmulator, addDoc, getDocs, onSnapshot, writeBatch, runTransaction, deleteDoc, and the supported FieldValue sentinels, and can switch unary calls between REST and gRPC-Web.
  • Tasks — the shared tasks task list. Firestore CRUD calls create, toggle, and delete tasks; an onSnapshot query keeps the newest-first list current without polling, delivered through the Listen bridge. It implements the full spec.