Metadata-Version: 2.4
Name: fireboss
Version: 1.0.0
Summary: FireBoss - Modern Firebase Management Panel
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# 🔥 FireBoss - Firebase Manager Panel

FireBoss is an intuitive Firebase Management GUI & Administration Panel built with React, Tailwind CSS, Monaco Editor, and the Firebase Admin SDK for Node.js.

It gives developers, DevOps engineers, and product teams full administrative capabilities over their Firebase projects without being limited by client security rules or the official console's constraints.

---

## ⚡ Key Features

- **Multi-Project Management**: Switch between Development, Staging, and Production projects with one click.
- **Firestore Explorer**:
  - 3-column navigation: Collections -> Documents -> Monaco JSON Editor.
  - Subcollection traversal and deep path discovery.
  - Visual Query Builder (`==`, `!=`, `>`, `<`, `array-contains`, etc.).
  - Batch Import & Export of collections (JSON/CSV).
- **Authentication & Custom Claims (RBAC)**:
  - Searchable directory of users.
  - Edit user profiles, disable accounts, and send password reset links.
  - Interactive Custom Claims JSON editor (e.g. setting `role: admin`, `tier: enterprise`).
  - Revoke active session tokens.
- **Cloud Storage Explorer**:
  - S3-like bucket file browser with folder navigation.
  - Drag-and-drop file upload.
  - Visual image and file preview.
  - Temporary signed download URL generation.
- **Realtime Database (RTDB)**:
  - Interactive collapsible JSON tree.
  - Live in-place value editing.
  - Raw JSON Monaco editor with syntax validation.
- **Cloud Messaging (FCM) Tester**:
  - Dispatch test push notifications to Device Registration Tokens or Topic broadcasts.
  - Custom key-value data payload composer.
  - Real-time response inspection and dispatch history log.
- **Demo Mode**: Test and explore all features immediately with realistic sample datasets without requiring initial Firebase credentials.

---

## 🚀 Quick Start

### 1. Install Dependencies

```bash
# In the root directory (d:/FireBoss)
npm.cmd run install:all
```

Or install separately:
```bash
npm.cmd install --prefix server
npm.cmd install --prefix client
```

### 2. Start FireBoss in Development Mode

```bash
npm.cmd run dev
```

- **Client**: `http://localhost:3000`
- **Server API**: `http://localhost:5000`

---

## 🛡️ Connecting Your Firebase Project

1. Go to your [Firebase Console](https://console.firebase.google.com/) -> **Project Settings** -> **Service Accounts**.
2. Click **Generate new private key** and download the `.json` file.
3. In FireBoss, click **Connect New Project** in the top navigation bar.
4. Drag and drop your `.json` file or paste its contents.
5. Click **Connect Project** to start managing your live Firebase project!
