PromptBase

Overview

PromptBase is a centralized, searchable repository for storing and managing prompts used in AI models, chatbots, or any generative application. It provides a structured way to organize, tag, search, and reuse prompts—streamlining prompt engineering for developers, teams, and enthusiasts.

Features

• Prompt Types: Categorize prompts as System or Task
• Tagging: Add tags to describe and filter prompts
• Search: Keyword and full-text search with filter by type and tags
• Metadata: Each prompt includes:
  • Title
  • Description
  • Tags
  • Type
  • Created/Last modified timestamps
• Import/Export: Import/export prompts via JSON files
• Web UI: Clean interface to view, edit, and manage prompts
• Planned:
  • AI Integration: Suggest prompts using OpenAI, Together, or Ollama APIs
  • User auth and profiles
  • Prompt favorites and contributions
  • Ratings, version history, and sharing

Usage

You'll need a .env file with your Supabase credentials. See supabase.env.example.

Docker

To run the app using Docker, you can use the provided docker-compose.yml file.

services:
  frontend:
    container_name: PromptBase
    image: git.keithsolomon.net/keith/promptbase:main
    restart: unless-stopped

    environment:
      - NODE_ENV=production

    ports:
      - "4321:4321"

    volumes:
      - ./.env:/app/.env:ro  # Bind-mount .env as read-only

To run locally (for development)

npm install
npm run dev

Tech Stack

• Frontend: Astro js, Tailwind CSS
• Backend: Supabase (self-hosted)
• Deployment: Docker (frontend), Supabase (backend)

Database Schema

prompts

Column	Type
id	UUID
type	text
title	text
description	text
tags	array(text)
created_at	timestamp
updated_at	timestamp

Future tables: users, user_prompts

Development Roadmap

Development is organized into phases. For details, see checklist.md.

MVP Phases

1. Planning & Setup
2. Database & Supabase API
3. Front-End UI
4. Search & Tagging
5. Import/Export Functionality

Post-MVP Enhancements

• AI Prompt Suggestions
• User login with Supabase Auth
• User-contributed prompts and favorites
• Ratings, version control, external API
• Shareable links and embeds

Contributing

Pull requests are welcome! Please keep contributions focused on core functionality and usability improvements.