Skip to content

Getting started

FireFetch is a desktop application for Google Cloud Firestore. This page takes you from a fresh install to your first query.

Install

Download the build for your platform from the download page and install it the usual way for your operating system — drag to Applications on macOS, run the installer on Windows, or make the AppImage executable on Linux.

First launch

On startup, FireFetch looks for credentials you already have. If you have signed in with the gcloud CLI or the Firebase CLI, it finds those and offers your projects immediately, so there is usually nothing to configure.

If it finds nothing, you have three options, covered in Connecting to Firestore:

  • Sign in with Google
  • Import a service-account JSON key
  • Connect to a local Firestore emulator

Your first query

  1. Pick a project, then a database, in the sidebar. Most projects have a single database called (default).
  2. Click a collection. FireFetch loads the first page of documents into the table.
  3. Add a filter using the query bar — a field, an operator and a value.
  4. Press Run.

Switch between table, tree, JSON and schema views using the view selector. They show the same result set in different shapes; the schema view is particularly useful on a collection you have not seen before, because it tells you which fields actually exist and how often.

Everything is read-only at first

You will notice you cannot edit anything yet. That is deliberate. Every database starts read-only, and you enable writes for one database at a time, when you mean to.

See Enabling write access for how and why.

Where to go next

Something unclear or out of date? Email[email protected].