Projects
What a project is in Firepanel, how to connect several, switch between them, and manage each one's settings.
A project in Firepanel maps one-to-one to a Firebase project you've connected. It's the top-level container for everything you do — the connected service account, the data you browse, and (soon) the team members who can access it.
What a project is#
When you connect a project, Firepanel stores:
- The Firebase project ID it detected from your service account.
- A nickname you choose (only visible to you and your team).
- Your encrypted service account credentials.
Everything you see under a project — collections, documents, saved views — is read live from that Firebase project. Firepanel doesn't hold a copy.
Connecting multiple projects#
You can connect as many Firebase projects as your plan allows. Most people connect at least two — a staging/development project and production — so they can work in the right environment without mixing them up.
To add another, go to your projects page and click Connect a project again. Each one needs its own service account key.
Tip
Give projects nicknames that make the environment obvious, like
acme-staging and acme-production. The nickname is what shows up in the
project switcher and the command palette.
Switching between projects#
Your projects page lists everything you've connected. Click a project to open it. Once you're inside, the fastest way to jump to another is the command palette: press ⌘K and start typing the project's nickname.
Project settings#
Each project has a settings area where you can:
- Rename the project (change its nickname).
- Re-verify the connection — re-run the Firestore/Auth/Storage health check if you've changed permissions on the Firebase side.
- Disconnect the project.
What happens when you disconnect#
Disconnecting a project permanently deletes its encrypted credentials from Firepanel. Firepanel immediately loses all access to that Firebase project.
Note
Disconnecting only removes Firepanel's stored key — it never touches your Firebase project or your data. Your Firestore documents, Auth users, and Storage files are untouched. To reconnect later, generate a fresh key and connect again.
Team access#
Today, the person who connects a project manages it. Shared team access with roles (owner, admin, editor, viewer) is coming soon — when it lands, you'll be able to invite teammates to a project and control what each of them can do.
Next#
Curious what's happening under the hood when you browse data? Read How Firepanel works.