Files
PromptBase/README.md
Keith Solomon 1185e35a1d 📄 docs: Update readme
2025-07-22 12:11:40 -05:00

2.3 KiB

Prompt Catalog

Overview

The Prompt Catalog 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
  • AI Integration: Suggest prompts using OpenAI, Together, or Ollama APIs (in progress)
  • Web UI: Clean interface to view, edit, and manage prompts
  • Planned:
    • User auth and profiles
    • Prompt favorites and contributions
    • Ratings, version history, and sharing
    • External API access

Tech Stack

  • Frontend: Astro + HTMX + Alpine.js (AHA Stack)
  • Backend: Supabase (self-hosted)
  • Deployment: Vercel or Netlify (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 Development Checklist.md.

MVP Phases

  1. Planning & Setup
  2. Database & Supabase API
  3. Front-End UI from Front End Interface.png
  4. Search & Tagging
  5. AI Prompt Suggestions
  6. Import/Export Functionality

Post-MVP Enhancements

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

Usage

To run locally:

npm install
npm run dev

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

Contributing

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