feat(docs): 📚 Add comprehensive API reference and architecture overview

feat(docs): 🔄 Introduce backup & portability strategies for data safety

chore(docs): 📝 Document changelog highlights for version tracking

feat(docs): ☁️ Outline Cloudflare Pages deployment process

docs: 🤝 Create contributing guidelines for community involvement

docs: 🔑 Define core concepts and data model for better understanding

docs: 🗂️ Elaborate on developer guide for local development workflow

feat(docs): 🐳 Provide Docker deployment instructions for production

feat(docs): 💻 Detail Electron desktop app setup and usage

docs: 🚀 Create getting started guide for new users

docs: 🏃‍♂️ Explain different runtime modes for ByteBox

feat(docs): 🎨 Describe theming and appearance customization options

docs: 🛠️ Compile troubleshooting tips for common issues

style: 🎨 Add custom styles for ByteBox documentation

chore: 🔧 Add TypeScript configuration for better development experience

chore: 🌐 Configure Wrangler for Cloudflare Pages deployment

Author: sizzlebop

CHANGELOG.md

@@ -11,20 +11,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### 🐳 Docker Deploy & 🖥️ Electron Desktop App
 
-This release adds two new ways to run ByteBox: a Docker container for zero-setup server deployment, and a native Electron desktop app that packages ByteBox as a proper installed application (AppImage, .deb, .exe).
+This release adds two new ways to run ByteBox: a Docker container for zero-setup server deployment, and a native Electron desktop app that packages ByteBox as a proper installed application (AppImage, .deb).
 
 #### Added
 
+- **Linux desktop downloads** — Pre-built AppImage and .deb installers now available for direct download from the [ByteBox website](https://bytebox.pro/electron-desktop/), hosted on Cloudflare R2.
 - **Docker support** — Full containerised deployment via `docker compose up --build -d`. A two-stage Dockerfile (builder + slim runtime) compiles the app and bundles only what's needed. Data persists in a named Docker volume (`bytebox-data`) that survives restarts and image rebuilds.
 - **`docker-compose.yml`** — One-command orchestration with healthcheck, restart policy, and documented backup/restore commands.
 - **`docker-entrypoint.sh`** — Container entrypoint that runs `prisma migrate deploy` (idempotent) then starts Next.js — migrations are applied automatically on every boot.
 - **`.dockerignore`** — Keeps build context lean by excluding `node_modules`, `.next`, local databases, and Electron artifacts.
 - **Electron desktop app** — `npm run electron:dev` launches ByteBox as a native desktop window. The main process starts the Next.js server in-process, applies SQLite migrations directly (no Prisma CLI needed), and stores the database in the OS user-data directory.
 - **`electron/main.ts`** — Electron main process with in-process Next.js server, migration runner (pure `better-sqlite3`, no CLI), secure `BrowserWindow` config, and external-link routing to the system browser.
 - **`electron/preload.ts`** — Minimal secure preload exposing only `window.electronAPI.isElectron` and `platform` — `contextIsolation: true`, `nodeIntegration: false`.
-- **`electron-builder.yml`** — Build config targeting **AppImage** + **.deb** (Linux) and **NSIS .exe** (Windows), with macOS .dmg support when building on macOS.
+- **`electron-builder.yml`** — Build config targeting **AppImage** + **.deb** (Linux).
 - **`public/icon.png` as app icon** — Set as the BrowserWindow icon so ByteBox appears with its own icon in the taskbar and titlebar.
-- **New npm scripts**: `electron:compile`, `electron:dev`, `electron:build`, `electron:build:linux`, `electron:build:win`, `electron:build:mac`.
+- **New npm scripts**: `electron:compile`, `electron:dev`, `electron:build`, `electron:build:linux`.
 - **New devDependencies**: `electron`, `electron-builder`, `esbuild`, `concurrently`, `wait-on`.
 
 #### Changed

README.md

@@ -110,18 +110,26 @@ docker compose logs -f       # follow logs
 
 ### 🖥️ **Desktop App (Electron)**
 
-Runs ByteBox as a native installed application.
+Runs ByteBox as a native installed application. Currently available for **Linux**.
+
+**Download pre-built installers from the [ByteBox website](https://bytebox.pro/electron-desktop/):**
+
+| Format                | Link                                                                                                   |
+| --------------------- | ------------------------------------------------------------------------------------------------------ |
+| AppImage (any distro) | [ByteBox-2.4.0.AppImage](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/ByteBox-2.4.0.AppImage)   |
+| .deb (Debian/Ubuntu)  | [bytebox_2.4.0_amd64.deb](https://pub-52c1c4beebd34721b63e30b05b1b04de.r2.dev/bytebox_2.4.0_amd64.deb) |
+
+Or build from source:
 
 ```bash
 # Dev mode (hot-reload)
 npm run electron:dev
 
-# Build installers
+# Build installer (Linux)
 npm run electron:build:linux   # → release/*.AppImage + *.deb
-npm run electron:build:win     # → release/*-Setup.exe
 ```
 
-The database is stored in the OS user-data directory (`~/.config/ByteBox/` on Linux, `%APPDATA%\ByteBox\` on Windows) and survives app updates.
+The database is stored in the OS user-data directory (`~/.config/ByteBox/` on Linux) and survives app updates.
 
 ---
 

former-field-backup

@@ -0,0 +1 @@
+Subproject commit 2813cdcb68d42de26abcfdc2bd3a4c7bdeecd5c0