aria-firestore

A local Firestore Explorer UI that runs in your browser. Browse collections, documents, and subcollections across all your Firebase projects — using your existing firebase login or gcloud credentials. No service accounts needed.

Quick Start

npx aria-firestore

Open http://localhost:4321 in your browser.

Custom port

PORT=8080 npx aria-firestore

Prerequisites

You need at least one of these:

• Firebase CLI — npm install -g firebase-tools && firebase login
• gcloud CLI — gcloud auth application-default login

Aria reads your locally stored credentials to authenticate with the Firestore REST API. Nothing is sent anywhere except to Google's APIs.

Features

• Multiple accounts — automatically detects all accounts from Firebase CLI (firebase login:add) and gcloud ADC. Switch between them in the UI.
• All projects — lists every Firebase project your account has access to, with search.
• Multiple databases — supports named databases (e.g. Firestore Enterprise), not just (default).
• Collection browser — navigate root collections, documents, subcollections, and nested documents with breadcrumb navigation.
• Document viewer — expandable JSON tree for document fields, with type-aware rendering (timestamps, geopoints, references, arrays, maps).
• Query builder — filter documents by field with operators (EQUAL, LESS_THAN, ARRAY_CONTAINS, etc.) and order results.
• Error handling — friendly messages for disabled APIs, with direct links to enable them in the Google Cloud Console.

How it works

Aria is a SvelteKit app bundled with adapter-node. When you run it:

1. Reads credentials from ~/.config/configstore/firebase-tools.json (Firebase CLI) and ~/.config/gcloud/application_default_credentials.json (gcloud ADC)
2. Uses those OAuth2 refresh tokens to call the Firebase Management API and Firestore REST API
3. Serves a local web UI on the specified port

All data stays local. The server only runs on localhost.

Development

git clone <repo-url>
cd aria
npm install
npm run dev

License

MIT