Ecosystem Setup Guide

How to create a new FireUX ecosystem and wire Firebase correctly.
Moved from /ecosystems
The setup guide now lives at /ecosystems/learn-more. /ecosystems is the live ecosystem directory.
Open ecosystems Dev details

Docs hierarchy

  • /ecosystems: browse active ecosystems.
  • /ecosystems/learn-more: create a new ecosystem and wire Firebase.
  • /apps: create global or tenant apps under an ecosystem.

1. Create Firebase project

  1. Create a new Firebase project and switch billing from Spark to Blaze.
  2. Enable Authentication, Firestore, and Storage.
  3. Create a Web app and save the Firebase web config values.
  4. Create a service account key for local admin/server tasks.

2. Scaffold ecosystem package

Use the repo-local scaffolder to generate package structure and baseline config. 

pnpm create:ecosystem -- --name <name> --firebase-project <firebase-project-id>

3. Place Firebase values correctly

  • Put core Firebase fields in ecosystem.config.ts.
  • Put NUXT_FIREBASE_APP_ID in the app .env.
  • Put optional NUXT_FIREBASE_MEASUREMENT_ID in the app .env.
  • Store service account JSON under the ecosystem config folder.
  • Set project binding in ecosystem .firebaserc.

4. Create global app

Continue to /apps for full app scaffolding, env setup, and deploy wiring.

5. Validate

pnpm guard
pnpm typecheck:packages
pnpm typecheck:apps
FireUX logoFIReUX © 2026All rights reserved.