README.md

# 🚀 OpenPrompt - AI Prompts Marketplace + Tools Suite

> **Production-ready platform combining a prompts marketplace with 177+ AI-powered tools, browser extension, and multi-model support**

[![Next.js](https://img.shields.io/badge/Next.js-16.0.8-black)](https://nextjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-blue)](https://www.typescriptlang.org/)
[![Prisma](https://img.shields.io/badge/Prisma-7.1-2D3748)](https://www.prisma.io/)
[![React](https://img.shields.io/badge/React-19.2-61DAFB)](https://react.dev/)

**Live Demo:** [https://open-prompt.netlify.app](https://open-prompt.netlify.app)

---

## 📖 Table of Contents

- [Features](#-features)
- [Tech Stack](#-tech-stack)
- [Getting Started](#-getting-started)
- [Project Structure](#-project-structure)
- [Browser Extension](#-browser-extension)
- [Available Tools](#-available-tools)
- [Deployment](#-deployment)
- [Documentation](#-documentation)
- [Support](#-support)

---

## ✨ Features

### Prompts Marketplace

- 🔍 **Advanced Search** - Full-text search with real-time filtering
- 📊 **Trending Algorithm** - Hot score calculation for viral prompts
- 🏷️ **7 Categories** - Content, Development, Marketing, Business, Education, Creative, Research
- ⭐ **User Engagement** - Star, share, remix, and collect prompts
- 👥 **Creator Economy** - Profile pages, rankings (Bronze/Silver/Gold/Verified), stats
- 🎨 **10 Frameworks** - RACE, CARE, APE, CREATE, RISEN, RTF, TAG, BAB, STAR, PREP
- 🏅 **Quality Badges** - Auto-calculated (Hot, Viral, Featured, Top Rated, etc.)
- 📦 **Collections** - Organize and share prompt collections
- 🔗 **Embeds** - Share prompts with 3 theme options
- 💬 **Comments** - Threaded discussions with likes and replies
- 🌓 **Dark Mode** - Beautiful light and dark themes

### AI Tools Suite (177 Tools Across 15 Categories)

- 🎯 **Prompting** (9) - Optimizer, Checker, Chain-of-Thought, Few-Shot, Meta-Prompt, etc.
- 📢 **Marketing** (14) - Strategy, Sales Copy, Hooks, Ads, Campaigns
- 🏢 **Branding** (11) - Business Names, Slogans, USP, Brand Voice
- ✍️ **Copywriting** (12) - Titles, Headlines, Meta, Landing Pages
- 💼 **Business** (15) - Plans, Mission, SWOT, Pitches, Financial Models
- 📧 **Email** (10) - Subject Lines, Cold Email, Sequences, Templates
- 📦 **Product** (12) - Descriptions, PRDs, User Stories, Roadmaps
- 💼 **HR** (11) - Job Descriptions, Interviews, Reviews, Onboarding
- ⭐ **Personal Brand** (8) - LinkedIn, Twitter, Instagram, Bio
- 📋 **Operations** (9) - SOPs, KPIs, Process Improvement
- 📱 **Social Media** (12) - Posts, Captions, Hashtags, Calendars
- 🎓 **Education** (10) - Lesson Plans, Quizzes, Curriculum
- 💻 **Development** (15) - Code Review, Documentation, APIs
- 🎨 **Creative** (14) - Stories, Scripts, Poetry, Art Prompts
- 🔬 **Research** (15) - Analysis, Summaries, Literature Review

### Image Prompts Gallery
- 🎨 **Midjourney** - v6.1, v6, v5.2, niji 6
- 🖼️ **DALL-E** - DALL-E 3, DALL-E 2
- 🎯 **Stable Diffusion** - SDXL, SD 3.5, SD 1.5
- ⚡ **FLUX** - FLUX.1-dev, schnell, pro
- 🦁 **Leonardo AI** - Phoenix, Kino XL, Vision XL
- 🔥 **Adobe Firefly** - Firefly 3, Firefly 2

### AI Characters
- 🤖 **Experts** - Coding, Writing, Business mentors
- 🎭 **Roleplay** - Storytelling, Adventure companions
- 🎓 **Education** - Tutors, Study buddies
- 💼 **Productivity** - Task assistants, Planners
- 🎨 **Creative** - Art directors, Music composers

### Thunderdome ⚔️
- **Model vs Model** - Compare AI responses head-to-head
- **Community Voting** - Real-time leaderboard
- **20+ Models** - GPT-4o, Claude 3.5, Gemini 2.5, Ollama models

### Workflow Chains 🔗
- **Multi-step Prompts** - Chain prompts together
- **Variable Passing** - Output → Input automation
- **Templates** - Pre-built workflow patterns

### Infrastructure

- ⚡ **Multi-Model AI** - OpenAI, Anthropic, Google AI, Ollama (20+ local models)
- 🔄 **Response Caching** - Redis with 7-day TTL
- 🛡️ **Rate Limiting** - 10/hr guests, 50/hr users
- 🤖 **Bot Protection** - Cloudflare Turnstile
- 📊 **Analytics** - Usage tracking, engagement metrics
- 🔐 **Authentication** - Stack Auth integration
- 📱 **Mobile Responsive** - Works on all devices
- 🧩 **Browser Extension** - Open prompts in any AI chat

---

## 🛠️ Tech Stack

**Frontend:**
- [Next.js 16.0.8](https://nextjs.org/) - React framework with Turbopack
- [React 19.2.1](https://react.dev/) - UI library
- [TypeScript 5.8](https://www.typescriptlang.org/) - Type safety
- [Tailwind CSS 4.x](https://tailwindcss.com/) - Styling
- [Shadcn/ui](https://ui.shadcn.com/) - UI components
- [Framer Motion](https://www.framer.com/motion/) - Animations

**Backend:**
- [Next.js API Routes](https://nextjs.org/docs/api-routes/introduction) - Serverless functions
- [Prisma 7.1](https://www.prisma.io/) - Database ORM
- [PostgreSQL](https://www.postgresql.org/) - Database (via Neon)
- [Redis](https://redis.io/) - Caching (via Upstash)

**AI & Services:**
- [OpenAI API](https://platform.openai.com/) - GPT-4o, GPT-4o-mini
- [Anthropic API](https://www.anthropic.com/) - Claude 3.5 Sonnet, Claude 3 Haiku
- [Google AI](https://ai.google.dev/) - Gemini 2.5 Flash, Gemini 2.0 Flash
- [Ollama](https://ollama.ai/) - 20+ local models (Llama, Mistral, Phi, etc.)
- [Stack Auth](https://stack-auth.com/) - Authentication
- [Cloudflare Turnstile](https://www.cloudflare.com/products/turnstile/) - Bot protection

**Deployment:**
- [Vercel](https://vercel.com/) - Hosting & deployments
- [GitHub](https://github.com/) - Version control

---

## 🚀 Getting Started

### Prerequisites

- Node.js 18+ 
- npm or yarn
- PostgreSQL database (or Neon account)
- OpenAI API key

### Installation

1. **Clone the repository**

```bash
git clone https://github.com/Anky9972/open-prompt.git
cd open-prompt
```

2. **Install dependencies**

```bash
npm install
```

3. **Set up environment variables**

Create `.env.local`:

```env
# Database
DATABASE_URL="postgresql://..."

# Authentication (Stack Auth)
NEXT_PUBLIC_STACK_PROJECT_ID="..."
NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY="..."
STACK_SECRET_SERVER_KEY="..."

# AI Models (Required)
OPENAI_API_KEY="sk-..."

# Optional
ANTHROPIC_API_KEY="sk-ant-..."
GOOGLE_AI_API_KEY="..."
UPSTASH_REDIS_REST_URL="..."
UPSTASH_REDIS_REST_TOKEN="..."
NEXT_PUBLIC_TURNSTILE_SITE_KEY="..."
TURNSTILE_SECRET_KEY="..."
```

4. **Set up database**

```bash
npx prisma generate
npx prisma db push
npx prisma db seed  # Optional: adds sample data
```

5. **Run development server**

```bash
npm run dev
```

Visit [http://localhost:3000](http://localhost:3000)

---

## 📁 Project Structure

```
openprompt/
├── src/
│   ├── app/                    # Next.js app directory
│   │   ├── api/               # API routes
│   │   ├── categories/        # Category pages
│   │   ├── category/          # Dynamic category
│   │   ├── collections/       # Collections
│   │   ├── create/            # Create prompt
│   │   ├── creators/          # Creators index
│   │   ├── creator/           # Creator profile
│   │   ├── embed/             # Embed pages
│   │   ├── explore/           # Explore page
│   │   ├── image-prompts/     # Image generation prompts
│   │   ├── characters/        # AI characters
│   │   ├── leaderboard/       # Creator rankings
│   │   ├── p/                 # Prompt runner
│   │   ├── thunderdome/       # Model comparison
│   │   ├── workflows/         # Workflow chains
│   │   ├── tools/             # AI tools suite
│   │   ├── about/             # About page
│   │   ├── docs/              # Documentation
│   │   ├── guides/            # User guides
│   │   ├── blog/              # Blog
│   │   ├── layout.tsx         # Root layout
│   │   └── page.tsx           # Landing page
│   ├── components/            # React components
│   │   ├── auth/              # Auth components
│   │   ├── comments/          # Comments system
│   │   ├── create/            # Creation components
│   │   ├── engagement/        # Engagement metrics
│   │   ├── explore/           # Discovery components
│   │   ├── layout/            # Layout (header, footer)
│   │   ├── prompt-runner/     # Prompt execution
│   │   ├── prompts/           # Prompt components
│   │   ├── thunderdome/       # Model comparison UI
│   │   ├── tools/             # Tool components
│   │   ├── workflow/          # Workflow builder
│   │   └── ui/                # Shadcn UI components
│   ├── lib/                   # Utilities
│   │   ├── prisma.ts          # Prisma client
│   │   ├── tools.ts           # 177 tool definitions
│   │   ├── frameworks.ts      # Prompt frameworks
│   │   └── utils.ts           # Helper functions
│   └── types/                 # TypeScript types
├── prisma/
│   ├── schema.prisma          # Database schema
│   └── seed.ts                # Seed data
├── openprompt-extension/      # Browser extension
│   ├── src/                   # Extension source
│   ├── dist/                  # Built extension
│   └── README.md              # Extension docs
├── public/                    # Static assets
├── DEPLOYMENT.md              # Deployment guide
├── FEATURE-GAP-ANALYSIS.md    # Feature roadmap
└── README.md                  # This file
```

---

## 🧩 Browser Extension

Open prompts directly in ChatGPT, Claude, Gemini, and other AI interfaces with one click!

### Supported Platforms
- ✅ ChatGPT (chatgpt.com)
- ✅ Claude (claude.ai)
- ✅ Gemini (gemini.google.com)
- ✅ Perplexity (perplexity.ai)
- ✅ Mistral (chat.mistral.ai)
- ✅ Microsoft Copilot (copilot.microsoft.com)

### Installation

```bash
cd openprompt-extension
npm install
npm run build
```

Then load the `dist` folder as an unpacked extension in Chrome.

See [openprompt-extension/README.md](openprompt-extension/README.md) for detailed instructions.

---

## 🔧 Available Tools

### 177 Tools Across 15 Categories

| Category | Count | Examples |
|----------|-------|----------|
| **Prompting** | 9 | Optimizer, Chain-of-Thought, Meta-Prompt |
| **Marketing** | 14 | Strategy, Ads, Campaigns, Funnels |
| **Branding** | 11 | Names, Slogans, Voice, Guidelines |
| **Copywriting** | 12 | Headlines, Landing Pages, CTAs |
| **Business** | 15 | Plans, SWOT, Pitches, Financials |
| **Email** | 10 | Sequences, Templates, Subject Lines |
| **Product** | 12 | PRDs, Roadmaps, User Stories |
| **HR** | 11 | Job Posts, Interviews, Onboarding |
| **Personal Brand** | 8 | LinkedIn, Twitter, Bio Generators |
| **Operations** | 9 | SOPs, KPIs, Process Improvement |
| **Social Media** | 12 | Posts, Reels, Calendars, Hashtags |
| **Education** | 10 | Lesson Plans, Quizzes, Curriculum |
| **Development** | 15 | Code Review, Docs, API Design |
| **Creative** | 14 | Stories, Scripts, Poetry, Art |
| **Research** | 15 | Analysis, Summaries, Literature |

See [src/lib/tools.ts](src/lib/tools.ts) for complete definitions.

---

## 🌐 Deployment

### Deploy to Vercel (Recommended)

1. **Push to GitHub**

```bash
git add .
git commit -m "Initial commit"
git push origin main
```

2. **Import to Vercel**

- Go to [vercel.com/new](https://vercel.com/new)
- Import your repository
- Add environment variables
- Deploy!

3. **Set up domain** (optional)

- Add custom domain in Vercel dashboard
- Configure DNS settings
- SSL automatically provisioned

For detailed instructions, see [DEPLOYMENT.md](DEPLOYMENT.md)

---

## 📚 Documentation

- **[DEPLOYMENT.md](DEPLOYMENT.md)** - Complete deployment guide
- **[FEATURE-GAP-ANALYSIS.md](FEATURE-GAP-ANALYSIS.md)** - Competitor analysis & roadmap
- **[openprompt-extension/README.md](openprompt-extension/README.md)** - Browser extension docs

---

## 🎯 Roadmap

### ✅ Current: v1.0 (Complete)
- ✅ Full prompts marketplace with 7 categories
- ✅ 177 AI tools across 15 categories
- ✅ Multi-model support (OpenAI, Anthropic, Google, Ollama)
- ✅ Thunderdome model comparison
- ✅ Workflow chains
- ✅ Image prompts gallery
- ✅ AI characters
- ✅ Comments & engagement
- ✅ Creator leaderboard
- ✅ Browser extension

### 🚧 Next: v1.5
- [ ] Prompt marketplace (buy/sell)
- [ ] Team workspaces
- [ ] API access
- [ ] Custom fine-tuning

### 🔮 Future: v2.0
- [ ] Mobile app
- [ ] Enterprise features
- [ ] White-label option
- [ ] Plugin ecosystem

---

## 💰 Monetization

### Free Tier
- All basic features
- 20 tool executions/day
- Community prompts

### Pro ($9/month)
- Unlimited tool executions
- Access to PRO tools
- Execution history
- Priority support

### Enterprise (Custom)
- API access
- Custom tools
- White-label
- SLA guarantee

---

## 📞 Support

- **Issues:** [GitHub Issues](https://github.com/Anky9972/open-prompt/issues)
- **Discussions:** [GitHub Discussions](https://github.com/Anky9972/open-prompt/discussions)
- **Email:** ankygaur9972@gmail.com
- **Twitter:** [@anky_vivek](https://x.com/anky_vivek)

---

## 🌟 Star History

If you find this project useful, please consider giving it a star ⭐

---

**Built with ❤️ by [Anky9972](https://github.com/Anky9972)**

[Website](https://open-prompt.netlify.app) · [Twitter](https://x.com/anky_vivek) · [GitHub](https://github.com/Anky9972/open-prompt)