Initial release: Firebase DevOps Toolkit v0.1.0 (Beta)

Enterprise-grade Firebase DevOps toolkit with 80+ production-ready scripts
for local development, team collaboration, and deployment automation.

⚠️ Beta Release - Feedback welcome!

Key Features:
- Local Development: Emulator management, Pub/Sub topics, resource monitoring
- Deployment: Multi-environment, selective deploy, function versioning
- Team Collaboration: Secure emulator sharing with 3 security levels
  • Basic sharing (ngrok tunnels)
  • Secure sharing (password protected)
  • Enterprise (HTTPS + auth tokens + rate limiting)
- Database: Firestore cleanup, schema inference, data backup/restore
- Testing: Function testing, health checks, auth validation
- Mobile Access: Share emulators securely with mobile devices

Includes:
- Starter project template for quick onboarding
- Comprehensive documentation
- Project structure guide
- Contributing guidelines

By SolidKey AB - https://solidkey.se

Author: ozgesolidkey

.env.example

@@ -0,0 +1,96 @@
+# Firebase Scripts Configuration Template
+# Copy this file to .env and configure for your project
+
+# ==============================================
+# CORE FIREBASE CONFIGURATION
+# ==============================================
+
+# Your Firebase project ID (REQUIRED)
+FIREBASE_PROJECT_ID=your-project-id
+
+# Firebase project ID for development/testing
+FIREBASE_DEV_PROJECT_ID=your-dev-project-id
+
+# Firebase region (e.g., us-central1, europe-west1)
+FIREBASE_REGION=us-central1
+
+# ==============================================
+# NETWORK CONFIGURATION
+# ==============================================
+
+# Local network IP address for mobile access
+# Get this with: ip route get 1.1.1.1 | grep -oP 'src \K\S+'
+# On macOS: ipconfig getifaddr en0
+LOCAL_NETWORK_IP=192.168.1.100
+
+# Alternative IP for mobile access (if different)
+MOBILE_ACCESS_IP=
+
+# ==============================================
+# PORT CONFIGURATION
+# ==============================================
+
+# HTTPS wrapper port
+HTTPS_PORT=8443
+
+# HTTP proxy port
+HTTP_PORT=8080
+
+# Firebase Emulator Ports
+EMULATOR_UI_PORT=4002
+EMULATOR_FUNCTIONS_PORT=5002
+EMULATOR_FIRESTORE_PORT=8085
+EMULATOR_AUTH_PORT=9100
+EMULATOR_HOSTING_PORT=5005
+
+# Your frontend/console port
+FRONTEND_PORT=3000
+
+# ==============================================
+# SERVICE CONFIGURATION
+# ==============================================
+
+# Your company/organization name
+COMPANY_NAME=YourCompany
+
+# Frontend/console application name
+FRONTEND_NAME=Console
+
+# Application name for display
+APP_NAME=Firebase Development Tools
+
+# ==============================================
+# SSL CERTIFICATE CONFIGURATION
+# ==============================================
+
+# Directory for SSL certificates (relative to project root)
+CERT_DIR=.certs
+
+# Certificate validity in days
+CERT_VALIDITY_DAYS=365
+
+# ==============================================
+# SECURITY CONFIGURATION
+# ==============================================
+
+# Rate limiting: requests per window
+RATE_LIMIT_MAX=20
+
+# Rate limiting: window in milliseconds
+RATE_LIMIT_WINDOW=10000
+
+# Session timeout in milliseconds (1 hour default)
+SESSION_TIMEOUT=3600000
+
+# ==============================================
+# DEVELOPMENT CONFIGURATION
+# ==============================================
+
+# Project root directory (auto-detected if not set)
+PROJECT_ROOT=
+
+# Log level (error, warn, info, debug)
+LOG_LEVEL=info
+
+# Enable debug mode
+DEBUG=false

.gcloudignore

@@ -0,0 +1,17 @@
+# This file specifies files that are *not* uploaded to Google Cloud
+# using gcloud. It follows the same syntax as .gitignore, with the addition of
+# "#!include" directives (which insert the entries of the given .gitignore-style
+# file at that point).
+#
+# For more information, run:
+#   $ gcloud topic gcloudignore
+#
+.gcloudignore
+# If you would like to upload your .git directory, .gitignore file or files
+# from your .gitignore file, remove the corresponding line
+# below:
+.git
+.gitignore
+
+node_modules
+#!include:.gitignore

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,39 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+A clear and concise description of what the bug is.
+
+## Steps to Reproduce
+1. Run command '...'
+2. With options '...'
+3. See error
+
+## Expected Behavior
+What you expected to happen.
+
+## Actual Behavior
+What actually happened.
+
+## Error Output
+```
+Paste any error messages or logs here
+```
+
+## Environment
+- **OS**: [e.g., macOS 14.0, Ubuntu 22.04, Windows 11 WSL]
+- **Node.js version**: [e.g., 18.17.0]
+- **Firebase CLI version**: [e.g., 13.0.0]
+- **Toolkit version**: [e.g., 1.0.0]
+- **Shell**: [e.g., bash 5.1, zsh 5.9]
+
+## Additional Context
+Add any other context about the problem here.
+
+## Possible Solution
+If you have an idea of what might fix this, please share!

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,33 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Problem Statement
+A clear description of what problem this feature would solve.
+Ex. "I'm always frustrated when..."
+
+## Proposed Solution
+Describe the solution you'd like. Be as specific as possible.
+
+## Example Usage
+```bash
+# How would this feature be used?
+./manage.sh your-new-command --option value
+```
+
+## Alternative Solutions
+Describe any alternative solutions or workarounds you've considered.
+
+## Use Case
+Who would benefit from this feature and how?
+
+## Additional Context
+Add any other context, screenshots, or examples about the feature request here.
+
+## Would you like to implement this?
+- [ ] Yes, I'd like to submit a PR for this feature
+- [ ] No, I'm just suggesting the idea

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,23 @@
+---
+name: Question
+about: Ask a question about using the toolkit
+title: '[QUESTION] '
+labels: question
+assignees: ''
+---
+
+## Question
+What would you like to know?
+
+## Context
+What are you trying to accomplish?
+
+## What I've Tried
+Describe any solutions you've already attempted.
+
+## Environment
+- **OS**: [e.g., macOS, Ubuntu, Windows WSL]
+- **Toolkit version**: [e.g., 1.0.0]
+
+## Additional Information
+Any other relevant details.

.github/pull_request_template.md

@@ -0,0 +1,35 @@
+## Description
+Brief description of what this PR does.
+
+## Type of Change
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+
+## Changes Made
+- Change 1
+- Change 2
+- Change 3
+
+## How to Test
+1. Step 1
+2. Step 2
+3. Expected result
+
+## Checklist
+- [ ] My code follows the project's style guidelines
+- [ ] I have tested my changes locally
+- [ ] I have updated the documentation (if applicable)
+- [ ] My changes don't break existing functionality
+- [ ] I have added comments where necessary
+
+## Related Issues
+Fixes #(issue number)
+
+## Screenshots (if applicable)
+Add screenshots to help explain your changes.
+
+## Additional Notes
+Any additional information reviewers should know.

.gitignore

@@ -0,0 +1,93 @@
+# Firebase DevOps Toolkit
+# Files that should be ignored by Git
+
+# =============================================================================
+# OS Generated Files
+# =============================================================================
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# =============================================================================
+# Editor / IDE
+# =============================================================================
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# =============================================================================
+# Logs
+# =============================================================================
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+firebase-debug.log
+firestore-debug.log
+ui-debug.log
+pubsub-debug.log
+
+# =============================================================================
+# Dependencies
+# =============================================================================
+node_modules/
+jspm_packages/
+.npm
+.yarn-integrity
+*.tgz
+
+# =============================================================================
+# Runtime / Temporary
+# =============================================================================
+pids/
+*.pid
+*.seed
+*.pid.lock
+*.tmp
+*.temp
+coverage/
+
+# =============================================================================
+# Environment & Config (Project-Specific)
+# =============================================================================
+.env
+.env.local
+.env.*.local
+
+# Project-specific configs (users create their own from templates)
+project-config.sh
+project-config-*.sh
+local-config.json
+.firebaserc
+
+# =============================================================================
+# Firebase / GCP Generated
+# =============================================================================
+.firebase/
+.certs/
+.emulator-sharing/
+emulator-data/
+
+# Generated schema files
+firestore-schema-*.json
+
+# =============================================================================
+# Build / Deploy Artifacts
+# =============================================================================
+dist/
+build/
+.cache/
+
+# =============================================================================
+# Archive / Backup (should not be in repo)
+# =============================================================================
+archive/
+backup/
+*.backup
+*.bak