Fuego
Emulator

Discover how Fuego improves Firebase Emulator workflows by addressing console limitations and simplifying production data imports for safe, efficient local testing.

big-idea

Testing Locally, Deploying Confidently: Fuego's Firebase Emulator Integration

When working with Firestore and Firebase Auth, local testing is essential — but the default Firebase Emulator experience can feel limiting. Fuego bridges that gap, giving you the same tools you rely on in production, without the risk of touching live data.

Why the Emulator Alone Isn’t Enough

Firebase’s emulator console is helpful for quick checks, but it’s even more limited than the Google Cloud console. Many common actions — like running complex queries, editing data in bulk, or inspecting nested structures — aren’t supported out of the box. That leaves you switching back and forth between tools or writing ad-hoc scripts just to test features locally.

Moving Real Data to the Emulator

If you want realistic test scenarios, you need real(ish) data. Unfortunately, copying production data into the emulator with the Firebase CLI is cumbersome. You often have to run multiple commands, manage export/import folders, and deal with mismatched formats or missing indexes. It’s tedious, easy to mess up, and slows down your development loop.

How Fuego Makes It Simple

  • One-Click Switching – Instantly toggle between your production database and the emulator without restarting your app or reconfiguring credentials.
  • Full-Featured Local Tools – Use the same query builder, data editor, and bulk operations locally as you do in production.
  • Safe Experimentation – Test complex writes, deletes, and updates without risking your live environment.

With Fuego’s emulator integration, you can build and debug with the confidence that when you deploy, the behavior will match what you tested — and you’ll get there faster, without fighting the tooling.


👉 Want to learn how to add and configure new emulators? Check out the detailed documentation in /docs/emulators for a step-by-step guide to integrating emulators in Fuego.