diff --git a/.cargo/config.toml b/.cargo/config.toml
index d42c757d31d..465854e8fe1 100644
--- a/.cargo/config.toml
+++ b/.cargo/config.toml
@@ -9,3 +9,7 @@ debug = "line-tables-only"
# cmake_minimum_required < 3.5; audiopus_sys's vendored opus declares 3.1.
# Same workaround CI uses. A value already set in the environment wins.
CMAKE_POLICY_VERSION_MINIMUM = "3.5"
+
+[target.x86_64-pc-windows-msvc]
+linker = "rust-lld"
+
diff --git a/Cargo.toml b/Cargo.toml
index 78816ff4827..139e141520f 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -162,6 +162,13 @@ opt-level = 1
[profile.ci.package."*"]
opt-level = 3
+[profile.dev]
+debug = true
+
+[profile.dev.package."*"]
+debug = false
+
+
# Sprig profile — optimized for deploy-anywhere Sprig release artifacts.
# Sprig is distributed over the network and installed on fresh hosts, so binary
# size matters more than compile speed here. Keep this separate from the normal
diff --git a/DISTRIBUTION_GUIDE.md b/DISTRIBUTION_GUIDE.md
new file mode 100644
index 00000000000..a94845c6c74
--- /dev/null
+++ b/DISTRIBUTION_GUIDE.md
@@ -0,0 +1,244 @@
+# Buzz Desktop & Server Distribution Guide
+
+This guide explains how to package and distribute the Buzz Desktop App (`.exe`) and the Buzz Relay Server (using Docker) to another person **without exposing your desktop application source code**.
+
+---
+
+## Architecture Overview
+
+```
+[ Your Machine (Developer) ]
+ ├─ 1. Build Desktop App ───► Buzz_x64-setup.exe (Compiled binary, no source code)
+ └─ 2. Prepare Server ──────► buzz-server.zip (docker-compose.yml + .env + start.bat)
+ │
+ ▼
+[ Recipient Machine ]
+ ├─ Run `start.bat` (Starts Server via Docker on port 3000)
+ └─ Run `Buzz_x64-setup.exe` (Connects automatically to local server)
+```
+
+---
+
+## Part 1: Build the Desktop `.exe`
+
+The desktop application is built using Tauri 2. When built in release mode, all React and TypeScript code is compiled directly into a native Windows binary.
+
+### 1. Prepare Sidecar Binaries (Required)
+Tauri validates the presence of sidecar binaries at build time. On Windows, run the following commands in PowerShell from the project root:
+
+```powershell
+# 1. Build release binaries for CLI & sidecars
+cargo build --release -p buzz -p buzz-acp -p buzz-agent -p buzz-dev-mcp -p git-credential-nostr
+
+# 2. Create the binaries directory in desktop/src-tauri
+New-Item -ItemType Directory -Force -Path "desktop\src-tauri\binaries"
+
+# 3. Copy binaries with the Windows target triple suffix (x86_64-pc-windows-msvc)
+$TARGET = "x86_64-pc-windows-msvc"
+Copy-Item "target\release\buzz.exe" "desktop\src-tauri\binaries\buzz-$TARGET.exe"
+Copy-Item "target\release\buzz-acp.exe" "desktop\src-tauri\binaries\buzz-acp-$TARGET.exe"
+Copy-Item "target\release\buzz-agent.exe" "desktop\src-tauri\binaries\buzz-agent-$TARGET.exe"
+Copy-Item "target\release\buzz-dev-mcp.exe" "desktop\src-tauri\binaries\buzz-dev-mcp-$TARGET.exe"
+Copy-Item "target\release\git-credential-nostr.exe" "desktop\src-tauri\binaries\git-credential-nostr-$TARGET.exe"
+
+# Create a placeholder stub for the unused kubernetes backend sidecar
+New-Item -ItemType File -Force -Path "desktop\src-tauri\binaries\buzz-backend-kubernetes-$TARGET.exe"
+```
+
+### 2. Run the Build Command
+Navigate to the `desktop` folder and run the Tauri release build:
+
+```powershell
+cd desktop
+pnpm install
+pnpm tauri build
+```
+
+### 3. Locate the Output Files
+Send one of the following generated files to the recipient:
+* **NSIS Installer**: `desktop\src-tauri\target\release\bundle\nsis\Buzz_0.5.4_x64-setup.exe`
+* **Standalone Executable**: `desktop\src-tauri\target\release\buzz.exe`
+
+---
+
+## Part 2: Package the Server for Docker
+
+Create a new directory called `buzz-server/` on your computer. Inside this folder, create the following four files. This folder will be zipped and sent to the recipient.
+
+### 1. `docker-compose.yml`
+```yaml
+name: buzz-server
+
+services:
+ relay:
+ image: ${BUZZ_IMAGE:-ghcr.io/block/buzz:main}
+ env_file:
+ - .env
+ environment:
+ BUZZ_BIND_ADDR: 0.0.0.0:3000
+ BUZZ_HEALTH_PORT: "8080"
+ BUZZ_METRICS_PORT: "9102"
+ DATABASE_URL: postgres://${POSTGRES_USER:-buzz}:${POSTGRES_PASSWORD:-buzz_secret}@postgres:5432/${POSTGRES_DB:-buzz}
+ REDIS_URL: redis://:${REDIS_PASSWORD:-redis_secret}@redis:6379
+ BUZZ_S3_ENDPOINT: http://minio:9000
+ BUZZ_S3_ADDRESSING_STYLE: path
+ BUZZ_S3_ACCESS_KEY: ${BUZZ_S3_ACCESS_KEY:-buzz_dev}
+ BUZZ_S3_SECRET_KEY: ${BUZZ_S3_SECRET_KEY:-buzz_dev_secret}
+ BUZZ_S3_BUCKET: ${BUZZ_S3_BUCKET:-buzz-media}
+ BUZZ_GIT_REPO_PATH: /data/git
+ BUZZ_AUTO_MIGRATE: "true"
+ ports:
+ - "3000:3000"
+ volumes:
+ - buzz-git-data:/data/git
+ depends_on:
+ postgres:
+ condition: service_healthy
+ redis:
+ condition: service_healthy
+ minio:
+ condition: service_healthy
+ minio-init:
+ condition: service_completed_successfully
+ restart: unless-stopped
+ networks:
+ - buzz-net
+
+ postgres:
+ image: postgres:17-alpine
+ environment:
+ POSTGRES_DB: ${POSTGRES_DB:-buzz}
+ POSTGRES_USER: ${POSTGRES_USER:-buzz}
+ POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-buzz_secret}
+ PGDATA: /var/lib/postgresql/data/pgdata
+ volumes:
+ - buzz-postgres-data:/var/lib/postgresql/data
+ healthcheck:
+ test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
+ interval: 5s
+ timeout: 5s
+ retries: 12
+ start_period: 10s
+ restart: unless-stopped
+ networks:
+ - buzz-net
+
+ redis:
+ image: redis:7-alpine
+ command: ["redis-server", "--appendonly", "yes", "--requirepass", "${REDIS_PASSWORD:-redis_secret}"]
+ environment:
+ REDIS_PASSWORD: ${REDIS_PASSWORD:-redis_secret}
+ volumes:
+ - buzz-redis-data:/data
+ healthcheck:
+ test: ["CMD-SHELL", "redis-cli -a \"$${REDIS_PASSWORD}\" ping | grep -q PONG"]
+ interval: 5s
+ timeout: 3s
+ retries: 12
+ start_period: 5s
+ restart: unless-stopped
+ networks:
+ - buzz-net
+
+ minio:
+ image: minio/minio:RELEASE.2025-09-07T16-13-09Z
+ command: server /data --console-address ":9001"
+ environment:
+ MINIO_ROOT_USER: ${BUZZ_S3_ACCESS_KEY:-buzz_dev}
+ MINIO_ROOT_PASSWORD: ${BUZZ_S3_SECRET_KEY:-buzz_dev_secret}
+ volumes:
+ - buzz-minio-data:/data
+ healthcheck:
+ test: ["CMD", "curl", "-f", "http://127.0.0.1:9000/minio/health/live"]
+ interval: 5s
+ timeout: 5s
+ retries: 12
+ start_period: 10s
+ restart: unless-stopped
+ networks:
+ - buzz-net
+
+ minio-init:
+ image: minio/mc:RELEASE.2025-08-13T08-35-41Z
+ depends_on:
+ minio:
+ condition: service_healthy
+ environment:
+ BUZZ_S3_ACCESS_KEY: ${BUZZ_S3_ACCESS_KEY:-buzz_dev}
+ BUZZ_S3_SECRET_KEY: ${BUZZ_S3_SECRET_KEY:-buzz_dev_secret}
+ BUZZ_S3_BUCKET: ${BUZZ_S3_BUCKET:-buzz-media}
+ entrypoint: >
+ /bin/sh -euc '
+ mc alias set local http://minio:9000 "$${BUZZ_S3_ACCESS_KEY}" "$${BUZZ_S3_SECRET_KEY}"
+ mc mb --ignore-existing "local/$${BUZZ_S3_BUCKET}"
+ mc anonymous set none "local/$${BUZZ_S3_BUCKET}"
+ '
+ restart: "no"
+ networks:
+ - buzz-net
+
+volumes:
+ buzz-postgres-data:
+ buzz-redis-data:
+ buzz-minio-data:
+ buzz-git-data:
+
+networks:
+ buzz-net:
+ driver: bridge
+```
+
+### 2. `.env`
+```ini
+BUZZ_IMAGE=ghcr.io/block/buzz:main
+BUZZ_DOMAIN=localhost:3000
+RELAY_URL=ws://localhost:3000
+BUZZ_MEDIA_BASE_URL=http://localhost:3000/media
+BUZZ_MEDIA_SERVER_DOMAIN=localhost:3000
+BUZZ_CORS_ORIGINS=http://localhost:3000
+
+BUZZ_REQUIRE_AUTH_TOKEN=false
+BUZZ_REQUIRE_RELAY_MEMBERSHIP=false
+BUZZ_AUTO_MIGRATE=true
+
+POSTGRES_DB=buzz
+POSTGRES_USER=buzz
+POSTGRES_PASSWORD=buzz_secret
+REDIS_PASSWORD=redis_secret
+BUZZ_S3_ACCESS_KEY=buzz_dev
+BUZZ_S3_SECRET_KEY=buzz_dev_secret
+BUZZ_S3_BUCKET=buzz-media
+```
+
+### 3. `start.bat`
+```bat
+@echo off
+echo ===================================================
+echo Starting Buzz Relay Server...
+echo ===================================================
+docker compose up -d
+echo.
+echo Server is running on http://localhost:3000
+echo You can now launch the Buzz Desktop App!
+pause
+```
+
+### 4. `stop.bat`
+```bat
+@echo off
+echo Stopping Buzz Relay Server...
+docker compose down
+echo Server stopped.
+pause
+```
+
+---
+
+## Part 3: Instructions for the Recipient
+
+Send the recipient the **`.exe` file** and the **zipped `buzz-server` folder**. They should execute the following steps to run them:
+
+1. **Install Docker**: Download and start [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/).
+2. **Start the Server**: Extract `buzz-server.zip`, open the folder, and double-click **`start.bat`**. This will download the images (the first time) and launch the server in the background.
+3. **Launch the Client**: Install/run **`Buzz_0.5.4_x64-setup.exe`** (or the standalone `buzz.exe`). The app will automatically connect to your local backend on `ws://localhost:3000`.
+4. **Shutdown**: When done, double-click **`stop.bat`** to clean up the running containers.
diff --git a/GIT_WORKFLOW.md b/GIT_WORKFLOW.md
new file mode 100644
index 00000000000..9a96b3336fb
--- /dev/null
+++ b/GIT_WORKFLOW.md
@@ -0,0 +1,64 @@
+Assuming you've already added the `upstream` remote, here are the exact commands.
+
+## 1. Get the latest Buzz changes and update your `main`
+
+```bash
+git checkout main
+git fetch upstream
+git reset --hard upstream/main
+git push --force origin main
+```
+
+This makes your local `main` and your fork's `main` exactly match `block/buzz:main`.
+
+---
+
+## 2. Switch back to `orbit` and bring those changes in
+
+```bash
+git checkout orbit
+git merge main
+git push origin orbit
+```
+
+If there are merge conflicts, Git will pause the merge. Resolve the conflicts, then run:
+
+```bash
+git add .
+git commit
+git push origin orbit
+```
+
+---
+
+# Complete workflow (copy & paste)
+
+```bash
+git checkout main
+git fetch upstream
+git reset --hard upstream/main
+git push --force origin main
+
+git checkout orbit
+git merge main
+git push origin orbit
+```
+
+---
+
+## Before doing this, make sure:
+
+* ✅ You have **committed** or **stashed** any uncommitted work on `orbit`.
+* ✅ You're okay with `main` being reset to exactly match Buzz (which is the workflow you've chosen).
+
+After running these commands:
+
+* `main` will be identical to `block/buzz:main`.
+* `orbit` will contain the latest Buzz code plus all of your Orbit changes.
+* You can continue developing on `orbit` and push with:
+
+```bash
+git add .
+git commit -m "Your commit message"
+git push origin orbit
+```
diff --git a/Justfile b/Justfile
index 6c7740bc7ac..e261cbf6f59 100644
--- a/Justfile
+++ b/Justfile
@@ -54,16 +54,21 @@ setup: bootstrap
hooks:
#!/usr/bin/env bash
set -euo pipefail
- # Use the Hermit-pinned lefthook (bin/lefthook self-downloads on first use):
- # works with no pre-installed lefthook and guarantees the pinned version
- # rather than whatever happens to be on PATH.
- export PATH="{{justfile_directory()}}/bin:$PATH"
# --path-format=absolute guarantees an absolute path from every invocation context:
# without it, --git-common-dir returns ".git" from the main checkout and a
# relative hooksPath would break linked-worktree dispatch just like .hooks did.
HOOKS_DIR="$(git rev-parse --path-format=absolute --git-common-dir)/hooks"
git config --local core.hooksPath "$HOOKS_DIR"
- lefthook install --force
+ if command -v lefthook &>/dev/null; then
+ lefthook install --force
+ elif command -v pnpm &>/dev/null; then
+ pnpm dlx lefthook install --force
+ elif command -v npx &>/dev/null; then
+ npx -y lefthook install --force
+ else
+ export PATH="{{justfile_directory()}}/bin:$PATH"
+ lefthook install --force
+ fi
# Wipe development state and recreate a clean environment. Installed Buzz is preserved.
[confirm("This will DELETE all development data and preserve installed Buzz. Continue? (y/N)")]
@@ -165,11 +170,7 @@ _ensure-sidecar-stubs:
set -euo pipefail
TARGET=$(rustc -vV | sed -n 's|host: ||p')
mkdir -p desktop/src-tauri/binaries
- SIDECARS=(buzz-acp buzz-agent buzz-dev-mcp git-credential-nostr buzz)
- if [[ "$TARGET" != *windows* ]]; then
- SIDECARS+=(buzz-backend-kubernetes)
- fi
- for bin in "${SIDECARS[@]}"; do
+ for bin in buzz-acp buzz-agent buzz-dev-mcp git-credential-nostr buzz; do
touch "desktop/src-tauri/binaries/${bin}-${TARGET}"
done
@@ -262,9 +263,6 @@ desktop-release-build target="aarch64-apple-darwin":
mkdir -p desktop/src-tauri/binaries
touch "desktop/src-tauri/binaries/buzz-acp-$TARGET"
touch "desktop/src-tauri/binaries/buzz-agent-$TARGET"
- if [[ "$TARGET" != *windows* ]]; then
- touch "desktop/src-tauri/binaries/buzz-backend-kubernetes-$TARGET"
- fi
touch "desktop/src-tauri/binaries/buzz-dev-mcp-$TARGET"
touch "desktop/src-tauri/binaries/git-credential-nostr-$TARGET"
touch "desktop/src-tauri/binaries/buzz-$TARGET"
@@ -549,7 +547,7 @@ desktop-standalone *ARGS: _ensure-sidecar-stubs
cargo build -p buzz-acp -p buzz-agent -p buzz-backend-kubernetes -p buzz-dev-mcp -p buzz-cli -p git-credential-nostr
TARGET=$(rustc -vV | sed -n 's|host: ||p')
TARGET_DIR=$(cargo metadata --format-version 1 --no-deps | node -p "JSON.parse(require('fs').readFileSync(0, 'utf8')).target_directory")
- for bin in buzz-acp buzz-agent buzz-backend-kubernetes buzz-dev-mcp git-credential-nostr buzz; do
+ for bin in buzz-acp buzz-agent buzz-dev-mcp git-credential-nostr buzz; do
cp "${TARGET_DIR}/debug/${bin}" "desktop/src-tauri/binaries/${bin}-${TARGET}"
chmod +x "desktop/src-tauri/binaries/${bin}-${TARGET}"
done
diff --git a/SETUP.md b/SETUP.md
new file mode 100644
index 00000000000..fbae524b330
--- /dev/null
+++ b/SETUP.md
@@ -0,0 +1,225 @@
+# Buzz Development & Setup Guide
+
+This guide provides a comprehensive walkthrough for setting up, running, and building the Buzz ecosystem locally on a Windows PC.
+
+---
+
+## 🏗️ Architecture Overview
+
+The Buzz project spans multiple components structured within a monorepo workspace:
+
+* **`crates/`**: The core backend Rust services.
+ * `buzz-relay`: WebSocket relay server (NIP-29 protocol).
+ * `buzz-db`: Postgres access layer.
+ * `buzz-cli`: Command Line Interface for agents/users.
+* **`desktop/`**: Tauri 2 + React 19 desktop application wrapper.
+* **`web/`**: Browser-based repository viewer/client.
+* **`migrations/`**: SQL database migration files.
+
+---
+
+## 📋 Prerequisites
+
+Ensure the following tools are installed and configured on your Windows system:
+
+| Tool | Required Version | Status / Action |
+| :--- | :--- | :--- |
+| **Docker Desktop** | Latest | *User Action: Pre-installed & Running* |
+| **C++ Build Tools** | MSVC v143+ | *User Action: Pre-installed via VS Build Tools* |
+| **CMake** | Latest | Install via `winget install -e --id Kitware.CMake` (Ensure it is in your system `PATH`) |
+| **Rust Toolchain** | 1.88+ | Install via [rustup.rs](https://rustup.rs/) |
+| **Node.js** | 24+ | Download from [nodejs.org](https://nodejs.org/) |
+| **pnpm** | 10+ | Install globally: `npm install -g pnpm` |
+| **Just** | Latest | Install task runner: `cargo install just` |
+
+---
+
+## 🏃 Quick Start: How to Run and Test the Desktop App
+
+To test the desktop app, follow these steps in order.
+
+### Step 1: Open Git Bash or a Bash Terminal
+Because the project's task runner (`just`) relies on Bash interpreter scripts, you **must run these commands from Git Bash** (or Windows PowerShell with Git's `usr/bin` folder added to your environment `PATH` variable).
+
+1. Open **Git Bash**.
+2. Change directory to the repository root:
+ ```bash
+ cd "c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit"
+ ```
+
+### Step 2: Start Docker Desktop & Configure PATH
+Before running the setup commands, you **must** ensure Docker is running and available in your terminal's environment (otherwise `just bootstrap` will fail with "Docker is required but not installed").
+
+1. **Launch Docker Desktop**: Open the Windows Start menu, search for **Docker Desktop**, and open it. Wait until the Docker engine shows as "Running" (green icon in the bottom left).
+2. **Enable CLI Integration (Crucial for Git Bash)**:
+ * In Docker Desktop, click the **Gear icon (Settings)** in the top right.
+ * Go to **Advanced** (or **General**, depending on version).
+ * Ensure the setting to **Add Docker CLI tools to PATH** (or "User/System PATH") is **checked/enabled**.
+ * *Note: If you just enabled this, you **MUST restart Git Bash** completely for it to detect the `docker` command.*
+
+### Step 3: One-Time Bootstrap & Setup (Workspace Root)
+Once Docker is running and your terminal can recognize the `docker` command, prepare the environment.
+
+1. **Bootstrap the environment configurations**:
+ * **Directory**: `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit`
+ * **Command**:
+ ```bash
+ just bootstrap
+ ```
+2. **Provision local databases, run migrations, and install JS dependencies**:
+ * *Note: This step downloads all required Docker images (Postgres, Redis, etc.) and starts them.*
+ * **Directory**: `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit`
+ * **Command**:
+ ```bash
+ just setup
+ ```
+
+### Step 3: Run the Application (Choose one method below)
+
+#### Method A: Full App & Local Relay Server (Recommended for Backend + Frontend testing)
+This runs the local WebSocket relay server (connected to Postgres & Redis in Docker) and automatically launches the compiled Tauri Desktop App wrapper.
+* **Directory**: `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit`
+* **Command**:
+ ```bash
+ just dev
+ ```
+* **What to expect**: A window containing the Tauri desktop client should pop up. The command terminal will output active relay server logs.
+
+#### Method B: Standalone Desktop App (Frontend Only, connecting to Remote/Public Relay)
+If you want to run the native application window without spinning up local databases or the backend relay:
+* **Directory**: `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit`
+* **Command**:
+ ```bash
+ just desktop-standalone
+ ```
+
+#### Method C: Web Dev Server (React Frontend in the Browser)
+If you just want to test and develop the React layout inside your Chrome/Edge browser instead of compiling the native Tauri wrapper:
+* **Directory**: `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit/desktop`
+* **Command**:
+ ```bash
+ pnpm dev
+ ```
+* **What to expect**: Open [http://localhost:5173](http://localhost:5173) in your browser.
+
+#### Method D: Manual Execution (Without `just` runner)
+If you prefer not to use the `just` task runner and want to navigate and start the services manually:
+
+##### 1. Start the Relay Server Manually
+1. Open Git Bash (or your preferred shell) and start the Docker services:
+ ```bash
+ docker compose up -d
+ ```
+2. Apply database migrations:
+ ```bash
+ cargo run -p buzz-admin -- migrate
+ ```
+3. Seed the local community data:
+ ```bash
+ ./scripts/seed-local-community.sh
+ ```
+4. Start the backend relay server:
+ ```bash
+ cd crates/buzz-relay
+ cargo run
+ ```
+
+##### 2. Start the Desktop Client Manually
+1. In a separate terminal, ensure sidecar placeholders exist (required by Tauri at compile time):
+ * **On Windows (Git Bash)**:
+ ```bash
+ mkdir -p desktop/src-tauri/binaries
+ TARGET=$(rustc -vV | sed -n 's|host: ||p')
+ for bin in buzz-acp buzz-agent buzz-dev-mcp git-credential-nostr buzz; do
+ touch "desktop/src-tauri/binaries/${bin}-${TARGET}.exe"
+ done
+ ```
+ * **On macOS/Linux**:
+ ```bash
+ mkdir -p desktop/src-tauri/binaries
+ TARGET=$(rustc -vV | sed -n 's|host: ||p')
+ for bin in buzz-acp buzz-agent buzz-dev-mcp git-credential-nostr buzz; do
+ touch "desktop/src-tauri/binaries/${bin}-${TARGET}"
+ done
+ ```
+2. Navigate to the `desktop` folder, load the environment configuration, and run the Tauri dev command:
+ ```bash
+ cd desktop
+ pnpm install
+ source ../scripts/instance-env.sh
+ pnpm exec tauri dev --config "$BUZZ_TAURI_CONFIG"
+ ```
+
+---
+
+## ⚙️ First-Time Setup Details
+
+Detailed setup options run from the root directory `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit`:
+
+### 1. Set Up Git Commit Hooks (Optional)
+Install the pre-commit hooks that automatically format code and check for issues before commits:
+* **Directory**: `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit`
+* **Command**:
+ ```bash
+ just hooks
+ ```
+
+---
+
+## 🚀 Detailed Workspace Commands & Locations
+
+Below is a cheat sheet indicating exactly **where** to run each command:
+
+| Goal / Action | Command to Run | Target Directory |
+| :--- | :--- | :--- |
+| **Full Stack Dev (Relay + Tauri App)** | `just dev` | `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit` |
+| **Standalone Tauri App** | `just desktop-standalone` | `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit` |
+| **Launch Local Web Client** | `pnpm dev` | `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit/desktop` |
+| **Start Only Local Relay** | `just relay` | `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit` |
+| **Show Docker Container Status** | `just ps` | `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit` |
+| **Stop All Docker Containers** | `just down` | `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit` |
+| **Factory Reset Database/State** | `just reset` | `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit` |
+
+---
+
+## 🛠️ Building the Desktop Application
+
+To compile the application into a distribution-ready installer (`.exe`/`.msi`):
+
+### Option 1: Using the Just task runner
+* **Directory**: `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit`
+* **Command**:
+ ```bash
+ just desktop-release-build target="x86_64-pc-windows-msvc"
+ ```
+
+### Option 2: Manually building via Tauri CLI
+* **Directory**: `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit/desktop`
+* **Commands**:
+ ```bash
+ pnpm install
+ pnpm tauri build
+ ```
+The compiled installer will be saved to:
+`c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit/desktop/src-tauri/target/release/bundle/`
+
+---
+
+## 🧹 Maintenance & Troubleshooting
+
+### Tail Docker Logs
+* **Directory**: `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit`
+* **Command**:
+ ```bash
+ just logs
+ ```
+
+### Run CI Checks Locally
+To verify everything compiles and formats correctly before pushing code:
+* **Directory**: `c:/Users/Yash Avsarmal/Downloads/orbit-main/orbit`
+* **Command**:
+ ```bash
+ just ci
+ ```
+*(If formatting or lints fail, run `just fix-all` to auto-format files workspace-wide)*
+
diff --git a/admin-web/index.html b/admin-web/index.html
index 961040e83ff..1f483d030d4 100644
--- a/admin-web/index.html
+++ b/admin-web/index.html
@@ -5,7 +5,7 @@
- Buzz admin
+ Orbit admin
diff --git a/admin-web/package.json b/admin-web/package.json
index 3f3eeebd875..60297e31f85 100644
--- a/admin-web/package.json
+++ b/admin-web/package.json
@@ -1,5 +1,5 @@
{
- "name": "buzz-admin-web",
+ "name": "orbit-admin-web",
"private": true,
"version": "0.1.0",
"type": "module",
diff --git a/admin-web/public/favicon.svg b/admin-web/public/favicon.svg
index 716bbd3dc62..9119eebc219 100644
--- a/admin-web/public/favicon.svg
+++ b/admin-web/public/favicon.svg
@@ -1,20 +1,50 @@
-