chore: update documentation for ByteBox v2.5.1 release

- Removed outdated AGENTS.md file.
- Consolidated general rules and branding information into copilot-instructions.md.
- Updated CHANGELOG.md with new downloads section for v2.5.1.
- Revised OVERVIEW.md to reflect the latest version and last updated date.
- Enhanced README.md with installation instructions for desktop app and Docker.
- Improved website documentation for getting started, running ByteBox, and installation options.

Author: sizzlebop

.codex/AGENTS.md

@@ -1,5 +1,19 @@
 # ByteBox - Development Guidelines
 
+## General Rules
+
+- Always sound friendly and engaged with this project.
+- Use all available agents, skills, and tools autonomously as needed.
+- Always refer to all instruction files at the start of new tasks.
+- Use Context7 tools for up-to-date framework/API documentation before coding.
+- Check the system date/time before updating CHANGELOG.md.
+- Thoroughly understand the full codebase context before making any changes. When uncertain, ask for clarification.
+- Keep `OVERVIEW.md` (technical overview document), `README.md`, and `CHANGELOG.md` current. Create them if they don't exist.
+- Create an Apache 2.0 `LICENSE` file if none exists.
+- Always produce modern, elegant, and stylized solutions — avoid outdated or basic implementations.
+
+**Important:** Do NOT change files unless you fully understand the project structure and intent.
+
 ## Tech Stack
 
 | Technology        | Version  | Purpose                         |
@@ -190,4 +204,19 @@ The `UserSettings` table always has exactly one row with `id = "default"`. Never
 ## Brand
 
 - Primary: Pink `#ec4899` · Secondary: Purple `#8b5cf6`
-- File headers: `/** ByteBox - [Name]\n * Made with ❤️ by Pink Pixel */`
+
+---
+
+## Owner / Org Branding
+
+- **Name:** Pink Pixel
+- **Website:** [pinkpixel.dev](https://pinkpixel.dev)
+- **GitHub:** [github.com/pinkpixel-dev](https://github.com/pinkpixel-dev)
+- **Email:** admin@pinkpixel.dev
+- **Support Email:** support@pinkpixel.dev
+- **Discord:** @sizzlebopz
+- **Funding:** [buymeacoffee.com/pinkpixel](https://www.buymeacoffee.com/pinkpixel) · [ko-fi.com/sizzlebop](https://ko-fi.com/sizzlebop)
+- **Tagline:** "Dream it, Pixel it ✨”
+- **Signature:** “Made with 💖 by Pink Pixel”
+
+---

.github/AGENTS.md

@@ -42,6 +42,14 @@ This release rolls the feature work from `2.5.0` forward into a fresh `2.5.1` in
 - **Electron packaging fixes** for Turbopack alias packages, Prisma client bundling, and `better-sqlite3` Electron ABI handling
 - **Desktop packaging documentation updates** and refreshed release/download guidance
 
+#### Downloads
+
+| Platform                   | Link                                                                                                   |
+| -------------------------- | ------------------------------------------------------------------------------------------------------ |
+| Windows (.exe)             | [ByteBox.Setup.2.5.1.exe](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/ByteBox.Setup.2.5.1.exe) |
+| Linux AppImage             | [ByteBox-2.5.1.AppImage](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/ByteBox-2.5.1.AppImage)   |
+| Linux .deb (Debian/Ubuntu) | [bytebox_2.5.1_amd64.deb](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/bytebox_2.5.1_amd64.deb) |
+
 ## [2.5.0] - 2026-03-04
 
 ### 🎯 Category Ordering, Drag-and-Drop, Neon Glow UI & Electron Packaging Fix

.github/copilot-instructions.md

@@ -1,7 +1,7 @@
 # 📚 ByteBox – Project Overview
 
-**Last Updated**: March 5, 2026
-**Version**: 2.5.0
+**Last Updated**: March 12, 2026
+**Version**: 2.5.1
 **Author**: [Pink Pixel](https://pinkpixel.dev)
 **License**: Apache 2.0
 **Status**: ✅ Stable & Complete
@@ -595,13 +595,13 @@ bytebox/
 
 ### Color Palette
 
-| Color                | Value     | Usage                                   |
-| -------------------- | --------- | --------------------------------------- |
-| **Pink**             | `#ec4899` | Primary accent, gradients, focus states |
-| **Purple**           | `#8b5cf6` | Secondary accent, gradients             |
-| **Surface Base**     | `#0a0a0a` | Primary app background surface          |
-| **Surface Contrast** | `#ffffff` | High-contrast background/surface option |
-| **Text Primary Dark**| `#1f2937` | Dark text token for bright surfaces     |
+| Color                  | Value     | Usage                                   |
+| ---------------------- | --------- | --------------------------------------- |
+| **Pink**               | `#ec4899` | Primary accent, gradients, focus states |
+| **Purple**             | `#8b5cf6` | Secondary accent, gradients             |
+| **Surface Base**       | `#0a0a0a` | Primary app background surface          |
+| **Surface Contrast**   | `#ffffff` | High-contrast background/surface option |
+| **Text Primary Dark**  | `#1f2937` | Dark text token for bright surfaces     |
 | **Text Primary Light** | `#f9fafb` | Light text token for deep surfaces      |
 
 ### Typography
@@ -742,25 +742,30 @@ npm run dev  # → http://localhost:3000
 
 ## 🚀 Deployment Options
 
-### Vercel (Recommended)
+### 🖥️ Desktop Installers (Recommended for End Users)
 
-1. Connect GitHub repository to Vercel
-2. Set environment variable: `DATABASE_URL` (use hosted database or local SQLite)
-3. Deploy! 🎉
+ByteBox ships pre-built native installers via Cloudflare R2. No Node.js or Docker required.
 
-### Netlify
+| Platform                   | Download                                                                                               |
+| -------------------------- | ------------------------------------------------------------------------------------------------------ |
+| Windows (.exe)             | [ByteBox.Setup.2.5.1.exe](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/ByteBox.Setup.2.5.1.exe) |
+| Linux AppImage             | [ByteBox-2.5.1.AppImage](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/ByteBox-2.5.1.AppImage)   |
+| Linux .deb (Debian/Ubuntu) | [bytebox_2.5.1_amd64.deb](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/bytebox_2.5.1_amd64.deb) |
 
-1. Connect GitHub repository
-2. Set build command: `npm run build`
-3. Set publish directory: `.next`
-4. Deploy! 🎉
+The packaged Electron app runs a bundled Next.js server internally. The SQLite database is stored in the OS user-data directory and survives app updates:
 
-### Self-Hosted
+- Linux: `~/.config/ByteBox/bytebox.db`
+- Windows: `%APPDATA%\ByteBox\bytebox.db`
 
-1. Build the app: `npm run build`
-2. Start server: `npm run start`
-3. Configure reverse proxy (nginx/Apache)
-4. Use PM2 or systemd for process management
+### 🐳 Docker
+
+Zero host-dependency deployment with automatic migrations:
+
+```bash
+docker compose up --build -d
+```
+
+Open `http://localhost:1334`. Data persists in the `bytebox-data` Docker volume.
 
 ---
 

CHANGELOG.md

@@ -67,23 +67,35 @@
 
 ## 📦 Installation
 
-### Prerequisites
+### 🖥️ **Desktop App (Recommended)**
 
-- **Node.js** 18+ (LTS recommended)
-- **npm** or **pnpm** or **yarn**
+Download a pre-built native installer — no Node.js or Docker required.
+
+| Platform                   | Download                                                                                               |
+| -------------------------- | ------------------------------------------------------------------------------------------------------ |
+| Windows (.exe)             | [ByteBox.Setup.2.5.1.exe](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/ByteBox.Setup.2.5.1.exe) |
+| Linux AppImage             | [ByteBox-2.5.1.AppImage](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/ByteBox-2.5.1.AppImage)   |
+| Linux .deb (Debian/Ubuntu) | [bytebox_2.5.1_amd64.deb](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/bytebox_2.5.1_amd64.deb) |
 
-### ⚡ **Quick Setup (recommended)**
+**Linux AppImage:**
 
 ```bash
-git clone https://github.com/pinkpixel-dev/bytebox.git
-cd bytebox
-npm run setup
-npm run dev
+chmod +x ByteBox-2.5.1.AppImage
+./ByteBox-2.5.1.AppImage
 ```
 
-The `setup` script handles everything: creates `.env`, installs dependencies, generates the Prisma client, applies migrations, and seeds example data.
+**Linux .deb:**
 
-Then open **http://localhost:1334**.
+```bash
+sudo dpkg -i bytebox_2.5.1_amd64.deb
+```
+
+**Windows:** Run the `.exe` installer and follow the setup wizard.
+
+The database is stored in the OS user-data directory and survives app updates:
+
+- Linux: `~/.config/ByteBox/bytebox.db`
+- Windows: `%APPDATA%\ByteBox\bytebox.db`
 
 ---
 
@@ -108,76 +120,42 @@ docker compose logs -f       # follow logs
 
 ---
 
-### 🖥️ **Desktop App (Electron)**
-
-Runs ByteBox as a native installed application. Pre-built Linux installers are hosted on Cloudflare R2, and Windows installers are published through GitHub releases.
+### ⚡ **Clone & Run (Dev / Self-Host)**
 
-**Download pre-built installers from the [ByteBox website](https://bytebox.pro/electron-desktop/):**
+For contributors or advanced users who want to run ByteBox from source.
 
-| Format                | Link                                                                                                   |
-| --------------------- | ------------------------------------------------------------------------------------------------------ |
-| AppImage (any distro) | [ByteBox-2.5.1.AppImage](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/ByteBox-2.5.1.AppImage)   |
-| .deb (Debian/Ubuntu)  | [bytebox_2.5.1_amd64.deb](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/bytebox_2.5.1_amd64.deb) |
-
-Or build from source:
-
-```bash
-# Dev mode (hot-reload)
-npm run electron:dev
-
-# Build installer (Linux)
-npm run electron:build:linux   # → release/*.AppImage + *.deb
-```
-
-The database is stored in the OS user-data directory (`~/.config/ByteBox/` on Linux) and survives app updates.
-
----
+#### Prerequisites
 
-### 🔧 **Manual Setup**
+- **Node.js** 18+ (LTS recommended)
+- **npm** or **pnpm** or **yarn**
 
-### 1️⃣ **Clone the Repository**
+#### Quick Setup
 
 ```bash
 git clone https://github.com/pinkpixel-dev/bytebox.git
 cd bytebox
+npm run setup
+npm run dev
 ```
 
-### 2️⃣ **Create the environment file**
+The `setup` script handles everything: creates `.env`, installs dependencies, generates the Prisma client, applies migrations, and seeds example data.
 
-```bash
-cp .env.example .env
-```
+Then open **http://localhost:1334**.
 
-### 3️⃣ **Install Dependencies**
+#### Manual Setup (step-by-step)
 
 ```bash
+cp .env.example .env
 npm install
-```
-
-### 4️⃣ **Set Up the Database**
-
-```bash
 npx prisma generate
 npx prisma migrate deploy
-```
-
-### 5️⃣ **Seed the Database (Optional)**
-
-Populate with example cards:
-
-```bash
-npm run db:seed
-```
-
-### 6️⃣ **Start the Development Server**
-
-```bash
+npm run db:seed   # optional — seeds example cards
 npm run dev
 ```
 
 Open [http://localhost:1334](http://localhost:1334) in your browser. 🎉
 
-> **Note:** On first load, ByteBox automatically creates 5 default categories (Frontend, Backend, DevOps, Learning & Research, Ideas & Inspiration) if none exist. You can rename or delete them anytime.
+> **Note:** On first load, ByteBox automatically creates 5 default categories (Frontend, Backend, DevOps, Learning & Research, Ideas & Inspiration) if none exist.
 
 ---