firebase-dynamic-ports-setup

Generate per-developer Firebase emulator port mappings and configs from ports.json.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/ajelinek/skills-stash --skill firebase-dynamic-ports-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: firebase-dynamic-ports-setup
Source: https://github.com/ajelinek/skills-stash/tree/main/firebase-dynamic-ports-setup
Command: npx skills add https://github.com/ajelinek/skills-stash --skill firebase-dynamic-ports-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves port conflicts that occur when several developers run Firebase emulators on the same machine by generating per-developer port mappings and consistent configurations.

Core Features & Use Cases

  • Per-developer port isolation by prefixing base ports with an instance number (1–9).
  • Automated config generation: firebase.local.json and .env from ports.json to keep setup repeatable.
  • Conditional Functions emulator support based on project structure to avoid startup errors when no functions/ directory exists.
  • Reproducible onboarding, collaboration, and CI workflows with a shared, instance-specific setup.
  • Seamless integration with test runners and tooling via generated environment variables.

Quick Start

Run the setup script to configure per-developer ports and generate the necessary emulator config for your chosen instance.

Frequently Asked Questions about firebase-dynamic-ports-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent Firebase emulator port conflicts when multiple developers share the same host?

To prevent Firebase emulator port conflicts on a shared host, generate per-developer port mappings by prefixing base ports from ports.json with a unique instance number (1–9). This creates isolated configurations for each developer running emulators locally.

How do I automatically configure Firebase emulator ports for a new developer instance?

To automatically configure Firebase emulator ports, run the setup script to apply an instance number to base ports and generate firebase.local.json and .env files. This provides consistent, per-developer emulator configurations without manual port editing.

Does the Firebase emulator setup automatically include the Functions emulator?

The Firebase emulator setup conditionally includes the Functions emulator only if a functions/ directory exists in your project. This prevents startup errors when running emulator configurations for projects without Cloud Functions.

Can I use per-developer Firebase emulator configurations in CI workflows?

Yes, you can use per-developer Firebase emulator configurations in CI workflows and onboarding scenarios. The generated environment variables and instance-specific firebase.local.json files ensure reproducible setups across automated pipelines and local development.

What files do I need to set up isolated Firebase emulator environments?

To set up isolated Firebase emulator environments, you need a base ports.json file. The setup script reads this file to generate the final firebase.local.json and .env configurations with prefixed ports for each developer instance.