Skip to content

README.md

Latest commit

 

History

History
177 lines (129 loc) · 7.3 KB

README.md

File metadata and controls

177 lines (129 loc) · 7.3 KB
Raw

PromptForge

PromptForge 🔥

The open-source, community-driven library of high-quality AI prompts.
No accounts to browse. No paywalls. No tracking. Built by the community, for the community.

GitHub Stars GitHub Forks MIT License Open Issues Open PRs PRs Welcome Contributions Welcome

📖 About

PromptForge is a free, open-source library of curated, high-quality prompts for large language models. Think of it as a shared, public notebook of prompts that actually work — written, reviewed, and improved by the community.

🎯 Our Mission

A free, open, community-driven home for high-quality AI prompts. No accounts required to browse, no paywalls, no tracking. Built by the community, for the community.

We believe the best prompts should be open, discoverable, and improvable — not locked behind a subscription or a login wall.

✨ Features

  • 🔥 Curated prompt library — 14+ starter prompts across 7 categories (Coding, Writing, Analysis, Creative, Education, Productivity, Business).
  • 🧪 Built-in playground — test any prompt right in your browser, with {{variable}} auto-detection and live model output.
  • 🔍 Search & filter — find prompts by keyword, category, or popularity.
  • 👍 Community voting — upvote the prompts you love (deduped, no login required).
  • 📤 Open contributions — submit prompts via the in-app form or open a pull request.
  • 🎨 Beautiful & accessible — responsive, light/dark mode, keyboard-navigable, screen-reader friendly.
  • 🆓 Truly free — MIT licensed, no ads, no tracking, no premium tier. Ever.

🚀 Quick Start

Prerequisites

  • Node.js 18.18+ or Bun 1.0+
  • A package manager: bun (recommended), npm, pnpm, or yarn

Run locally

# 1. Clone
git clone https://github.com/Cryptoteep/promptforge.git
cd promptforge

# 2. Install dependencies
bun install   # or: npm install

# 3. Set up environment variables
cp .env.example .env
# Edit .env and add your z-ai API key (see .env.example)

# 4. Push the database schema & seed example prompts
bun run db:push
bun run prisma/seed.ts   # seeds 14 example prompts

# 5. Start the dev server
bun run dev

Open http://localhost:3000 in your browser. 🎉

Environment variables

Create a .env file (see .env.example):

DATABASE_URL="file:./db/custom.db"
# The z-ai SDK reads its API key from the environment.
# See https://z.ai for details.

🤝 Contributing

We love contributions! PromptForge is built by the community, and there are many ways to help — no coding experience required:

  • 📝 Add a prompt — submit via the in-app form, or open a PR editing prisma/seed.ts.
  • 🐛 Report a bug — open a bug report issue.
  • 💡 Suggest a feature — open a feature request.
  • 🎨 Improve the UI/UX — see issues labeled good first issue.
  • 📚 Improve docs — typos, clarifications, and translations all welcome.
  • ⭐ Star the repo — it helps others discover the project.

Please read our Contributing Guide and Code of Conduct before getting started.

Good first issues

New to the project? Look for issues labeled good first issue and help wanted. We're happy to mentor first-time contributors!

🗺️ Roadmap

  • Prompt library with search & categories
  • In-browser playground with {{variable}} support
  • Community voting (deduped, no login)
  • In-app prompt submission (pending review)
  • Shareable deep-links (?p=<id>)
  • Export prompts as JSON / Markdown
  • Keyboard shortcuts (⌘/Ctrl + Enter to run)
  • Featured prompt banner
  • Prompt collections / bundles
  • "Fork a prompt" to remix & improve
  • Prompt versioning & edit history
  • Translations (i18n) — help wanted!
  • Per-prompt discussion threads

See the open issues for the full list of proposed features and known issues.

🏗️ Tech Stack

Layer Technology
Framework Next.js 16 (App Router)
Language TypeScript
Styling Tailwind CSS 4 + shadcn/ui
Database Prisma + SQLite
AI z-ai-web-dev-sdk (LLM playground)
Animations Framer Motion
License MIT

📜 License

PromptForge is licensed under the MIT License — see LICENSE. You're free to use, modify, and distribute it, including commercially.

💖 Sponsors

PromptForge is a non-commercial, volunteer-maintained project. If it helps you, consider sponsoring or just ⭐ starring the repo — it means a lot.

🙏 Acknowledgements

  • Every contributor who adds a prompt, fixes a typo, or opens an issue.
  • The open-source projects we build on: Next.js, Prisma, Tailwind, shadcn/ui.

Built with care by the open-source community.
🐛 Found a bug? Report it · 💡 Have an idea? Suggest it · 📝 Got a prompt? Share it