Installation

Promptzy is available in several forms — pick the one that fits your workflow.

Web App (PWA)

Best for most users. Install directly from your browser — no app store needed.

npm Package

Run Promptzy locally in seconds with a single global install.

Docker

Self-host anywhere with a single docker compose up command.

Linux Desktop

Native Electron app — .deb or .AppImage for Linux.

---

Web App (PWA)

The easiest way to use Promptzy is at promptzy.pinkpixel.dev — no installation required. You can also install it as a Progressive Web App for a native-like experience.

On mobile (iOS / Android):

1. Open promptzy.pinkpixel.dev in your browser.
2. Tap the share / menu icon and choose “Add to Home Screen” or “Install App”.
3. Promptzy will appear on your home screen like a native app.

On Desktop (Chrome / Edge):

1. Visit promptzy.pinkpixel.dev.
2. Click the install icon (⊕) in the browser address bar.
3. Click Install — done!

Tip

PWA benefits include offline capability, faster load times, and automatic updates whenever a new version ships.

---

npm (Global Install)

1. Install globally:

   npm install -g @pinkpixel/promptzy

2. Launch Promptzy:

   promptzy

   Promptzy starts on http://localhost:4173 and opens in your browser automatically.

No installation needed (run with npx):

npx @pinkpixel/promptzy

Legacy commands (still work from older versions):

prompt-dashboard
ai-prompt-dashboard

---

Docker

Run Promptzy as a self-hosted web app in a container.

Quick Start

git clone https://github.com/pinkpixel-dev/promptzy.git
cd promptzy
docker compose up --build

Promptzy is now available at http://localhost:3000.

With Credentials

Bake your Supabase and Pollinations credentials into the image so they’re pre-filled on first launch:

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

Note

You can always configure credentials at runtime via the in-app Settings dialog — no rebuild needed.

Manual Build & Run

# Build the image
npm run docker:build
# docker build -t promptzy .

# Run the container
npm run docker:run
# docker run --rm -p 3000:80 promptzy

---

Linux Desktop App

Native Electron app for Linux — no browser required.

Package	Format	Download
Debian / Ubuntu / Mint	.deb	Promptzy-1.4.3-amd64.deb
Universal Linux	.AppImage	Promptzy-1.4.3.AppImage

.deb (Ubuntu / Debian)

wget https://pub-699cccf9e73e444da2db8cbfb168ab3a.r2.dev/Promptzy-1.4.3-amd64.deb
sudo dpkg -i Promptzy-1.4.3-amd64.deb

Launch Promptzy from your application menu or run promptzy in the terminal.

.AppImage (Universal)

wget https://pub-699cccf9e73e444da2db8cbfb168ab3a.r2.dev/Promptzy-1.4.3.AppImage
chmod +x Promptzy-1.4.3.AppImage
./Promptzy-1.4.3.AppImage

No installation needed — the AppImage runs anywhere.

---

Build from Source

Clone the repository and run the development server or build for production.

1. Clone the repository:

   git clone https://github.com/pinkpixel-dev/promptzy.git
   cd promptzy

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

   The app is now available at http://localhost:8080.

4. Build for production (optional):

   npm run build
   npm run preview

Note

You can also use bun install / bun run dev or yarn install / yarn dev instead of npm.

---

Next Steps

Once Promptzy is running, connect it to your Supabase database for cloud sync:

Supabase Setup → Set up your free cloud database and start syncing prompts.