@pinkpixel/promptzy 1.4.1 → 1.4.2

package/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to Promptzy will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.2] - 2026-03-01
+
+### Added
+
+- **🖥️ Electron Desktop App:** Native desktop application built with Electron 34
+  - Custom `app://` protocol serves the built SPA from `dist/` — react-router `BrowserRouter` routes work identically to the web version
+  - Secure architecture: `contextIsolation: true`, `nodeIntegration: false`, sandboxed renderer, minimal `contextBridge` surface
+  - Native app menu with File / Edit / View (zoom & fullscreen) / Window / Help (GitHub & Pink Pixel links)
+  - Right-click context menu for cut/copy/paste in editable fields
+  - All external links open in the system browser via `shell.openExternal`
+  - macOS traffic-light / `hiddenInset` title bar; proper dock behaviour
+  - Dev mode loads the Vite dev server (`http://localhost:8080`) automatically
+- **📦 Linux Binary Releases:** Pre-built Linux packages published to Cloudflare R2
+  - **Debian / Ubuntu / Mint (`.deb`):** [Promptzy-1.4.1-amd64.deb](https://pub-699cccf9e73e444da2db8cbfb168ab3a.r2.dev/Promptzy-1.4.1-amd64.deb)
+  - **Universal Linux (`.AppImage`):** [Promptzy-1.4.1.AppImage](https://pub-699cccf9e73e444da2db8cbfb168ab3a.r2.dev/Promptzy-1.4.1.AppImage)
+- **🐳 Docker Support:** Multi-stage Docker build for self-hosted deployments
+  - Stage 1 — Node 20 Alpine compiles the Vite SPA with optional `VITE_*` build args for baking in credentials
+  - Stage 2 — Nginx 1.27 Alpine serves static assets; SPA-aware `try_files` routing, security headers, gzip compression, and smart cache policies (immutable for hashed assets, no-cache for HTML)
+  - `docker-compose.yml` for one-command spin-up: `docker compose up --build`
+  - New npm scripts: `docker:build`, `docker:run`, `docker:up`, `electron:dev`, `electron:build`
+
 ## [1.4.1] - 2026-03-01
 
 ### Changed

package/README.md

@@ -9,7 +9,7 @@
 <div align="center">
 
 ![License](https://img.shields.io/badge/license-MIT-blue.svg)
-![Version](https://img.shields.io/badge/version-1.4.1-green.svg)
+![Version](https://img.shields.io/badge/version-1.4.2-green.svg)
 ![NPM](https://img.shields.io/npm/v/@pinkpixel/promptzy?color=red)
 ![React](https://img.shields.io/badge/React-19.1.0-61DAFB?logo=react)
 ![TypeScript](https://img.shields.io/badge/TypeScript-5.8.3-3178C6?logo=typescript)
@@ -17,6 +17,8 @@
 ![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-4.x-38B2AC?logo=tailwind-css)
 ![Supabase](https://img.shields.io/badge/Supabase-2.49.7-3ECF8E?logo=supabase)
 ![Build Status](https://img.shields.io/badge/build-passing-brightgreen)
+![Electron](https://img.shields.io/badge/Electron-34.x-47848F?logo=electron)
+![Docker](https://img.shields.io/badge/Docker-ready-2496ED?logo=docker)
 ![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)
 ![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)
 
@@ -31,6 +33,8 @@
 - **Refresh Prompts**: Manual refresh button to sync prompts after configuration changes
 - **AI Assistant**: Generate new prompts with AI — powered by [Pollinations](https://pollinations.ai), with selectable model and streaming responses
 - **Progressive Web App (PWA)**: Install as a mobile app directly from your browser
+- **Desktop App**: Native Electron app for Linux (more platforms coming)
+- **Docker**: Run anywhere with a single `docker compose up` command
 - **Modern UI**: Clean, responsive interface built with Shadcn/UI and Tailwind
 
 ## 🖥️ Screenshots
@@ -115,6 +119,62 @@ Promptzy can be installed as a mobile app directly from your browser! No app sto
 - 🏠 Easy access from your home screen
 - 🔄 Manual refresh button for syncing prompts after setup
 
+### 🖥️ Linux Desktop App (Electron)
+
+Download the native desktop app for Linux — no browser required.
+
+| Package                | Format      | Download                                                                                                 |
+| ---------------------- | ----------- | -------------------------------------------------------------------------------------------------------- |
+| Debian / Ubuntu / Mint | `.deb`      | [Promptzy-1.4.1-amd64.deb](https://pub-699cccf9e73e444da2db8cbfb168ab3a.r2.dev/Promptzy-1.4.1-amd64.deb) |
+| Universal Linux        | `.AppImage` | [Promptzy-1.4.1.AppImage](https://pub-699cccf9e73e444da2db8cbfb168ab3a.r2.dev/Promptzy-1.4.1.AppImage)   |
+
+**Install the `.deb` package:**
+
+```bash
+wget https://pub-699cccf9e73e444da2db8cbfb168ab3a.r2.dev/Promptzy-1.4.1-amd64.deb
+sudo dpkg -i Promptzy-1.4.1-amd64.deb
+```
+
+**Run the `.AppImage` (no install needed):**
+
+```bash
+wget https://pub-699cccf9e73e444da2db8cbfb168ab3a.r2.dev/Promptzy-1.4.1.AppImage
+chmod +x Promptzy-1.4.1.AppImage
+./Promptzy-1.4.1.AppImage
+```
+
+### 🐳 Docker
+
+Run Promptzy as a self-hosted web app in a Docker container.
+
+**Quick start (pre-built image from source):**
+
+```bash
+git clone https://github.com/pinkpixel-dev/promptzy.git
+cd promptzy
+docker compose up --build
+```
+
+Promptzy will be available at `http://localhost:3000`.
+
+**With Supabase & Pollinations credentials baked in:**
+
+```bash
+VITE_SUPABASE_URL=https://xxxx.supabase.co \
+VITE_SUPABASE_ANON_KEY=your_anon_key \
+VITE_POLLINATIONS_API_KEY=pk_your_key \
+docker compose up --build
+```
+
+**Or build & run manually:**
+
+```bash
+npm run docker:build   # docker build -t promptzy .
+npm run docker:run     # docker run --rm -p 3000:80 promptzy
+```
+
+> Credentials can also be configured at runtime through the in-app Settings dialog — no rebuild needed.
+
 ### Deployment
 
 For deploying to Cloudflare Pages or other platforms, see the [DEPLOYMENT.md](DEPLOYMENT.md) guide.
@@ -207,7 +267,9 @@ Open **Settings → AI Assistant Configuration**, uncheck **Use default system p
 - React Hook Form with Zod
 - Supabase for cloud storage
 - PWA (Progressive Web App) with Workbox (vite-plugin-pwa v1.2)
-- Cloudflare Pages for deployment
+- **Electron 34** — native desktop app (Linux `.deb` & `.AppImage`; Windows & macOS builds available)
+- **Docker** — multi-stage Nginx image for self-hosted deployments
+- Cloudflare Pages for hosted deployment
 
 ## 📋 Roadmap
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinkpixel/promptzy",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Promptzy - A modern, cute web application for managing and organizing your AI prompts, with tagging, search, and cloud storage.",
   "type": "module",
   "main": "dist/index.html",
@@ -57,7 +57,12 @@
     "lint": "eslint .",
     "preview": "vite preview",
     "start": "node bin/promptzy.js",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "electron:dev": "concurrently -k -n VITE,ELECTRON -c cyan,magenta \"npm run dev\" \"wait-on http://localhost:8080 && electron electron/main.cjs\"",
+    "electron:build": "npm run build && electron-builder",
+    "docker:build": "docker build -t promptzy .",
+    "docker:run": "docker run --rm -p 3000:80 promptzy",
+    "docker:up": "docker compose up --build"
   },
   "dependencies": {
     "@hookform/resolvers": "^5.2.2",
@@ -120,6 +125,9 @@
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react-swc": "^4.2.3",
+    "concurrently": "^9.2.1",
+    "electron": "^34.5.8",
+    "electron-builder": "^25.1.8",
     "eslint": "^9.39.3",
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.5.2",
@@ -128,6 +136,7 @@
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.56.1",
     "vite": "^7.3.1",
-    "vite-plugin-pwa": "^1.2.0"
+    "vite-plugin-pwa": "^1.2.0",
+    "wait-on": "^8.0.5"
   }
 }