# PromptUp

> The smart way to organize, create, and share AI prompts. Save prompts from ChatGPT, Claude, and Gemini with one click. Features template variables, AI-powered translations, collections, and a Chrome extension.

PromptUp is a full-stack web application that helps AI enthusiasts and professionals manage their prompt library. Create reusable prompts with template variables, organize them into collections, translate to 8 languages with AI, and share with the community.

## Why PromptUp?

- **Template Variables**: Create reusable prompts with `{{VARIABLE}}` placeholders that users can fill in before copying
- **AI Translation**: Translate prompts to 8 languages with one click while preserving code blocks and variables
- **Chrome Extension**: Save prompts directly from ChatGPT, Claude, Gemini, or any website
- **Collections**: Organize prompts into shareable, curated lists
- **Secret Sharing**: Share private prompts via time-limited links (24h to 30 days)
- **Fork & Customize**: Build on community prompts while crediting the original

## Key Features

### Template Variables
Add `{{LANDMARK}}`, `{{CITY}}`, or `{{城市}}` placeholders to create dynamic, reusable prompts. Set default values, and users can customize before copying. Supports any language for variable names.

### Multi-Language Support
- 8 supported languages with AI-powered translation
- Each language version has independent edit history
- Forking copies all translations automatically

### Chrome Extension
Save prompts from anywhere on the web:
- **One-Click Save** from ChatGPT (chat.openai.com), Claude (claude.ai), Gemini (gemini.google.com)
- **Text Selection** on any website (select 10+ characters)
- **Auto-Tagging** with source platform
- **Quick Access** to your library from toolbar

### Organization & Discovery
- **Collections**: Group prompts into public or private collections
- **Tags**: Multi-tag filtering with advanced search (`lang:english tags:chatgpt,cursor`)
- **Pinning**: Keep important prompts at the top
- **Trending**: Discover popular prompts from the community

### Sharing & Privacy
- **Public/Private**: Control visibility of each prompt
- **Secret Links**: Share private prompts with expiring links
- **Forking**: Copy and customize any public prompt
- **Export**: Download your library as JSON or CSV

## User Guide

- [Complete User Guide](/guide): Template variables, search, collections, troubleshooting
- [Chrome Extension](/extension): Installation, setup, and usage guide

## API Endpoints

### Authentication (`/api/auth`)
- POST `/register` - Register new user
- POST `/login` - Login with credentials
- GET `/logout` - Logout
- GET `/me` - Get current user
- POST `/forgot-password` - Request password reset
- GET `/verify-email` - Verify email token
- GET `/google` - Google OAuth login

### Prompts (`/api/prompts`)
- GET `/public` - List public prompts (paginated)
- GET `/trending` - Get trending prompts
- GET `/gallery` - Gallery view
- POST `/search` - Advanced search with filters
- GET `/:id` - Get single prompt
- GET `/raw/:id` - Get raw prompt code (text/plain)
- GET `/summary/:id` - Get prompt summary as structured JSON (title, description, tags, author, code snippet, translations) — optimized for AI engine consumption
- POST `/` - Create prompt (auth required)
- PUT `/:id` - Update prompt (owner only)
- DELETE `/:id` - Delete prompt (owner only)
- POST `/:id/fork` - Fork a prompt

### Tags (`/api/tags`)
- GET `/popular` - Popular tags with counts
- GET `/:tagName/prompts` - Prompts by tag

### Collections (`/api/users/collections`)
- GET `/` - List user's collections
- POST `/` - Create collection
- PUT `/:id` - Update collection
- DELETE `/:id` - Delete collection

### Likes & Saved (`/api/likes`, `/api/saved`)
- POST `/:id` - Like/save a prompt
- DELETE `/:id` - Unlike/unsave
- GET `/` - Get liked/saved prompts
- POST `/check-batch` - Batch check status

## Tech Stack

- Backend: Express.js, TypeScript, Sequelize ORM, PostgreSQL
- Frontend: React, TypeScript, shadcn/ui
- Auth: JWT (HTTP-only cookies), Google OAuth
- SEO: Sitemap index with paginated child sitemaps, JSON-LD (SoftwareSourceCode, Organization, BreadcrumbList, WebSite), prerendering

## Optional

- [Full API Documentation](/llms-full.txt): Complete endpoint specs, database schema, all routes
- [Architecture Overview](/docs/agent-guidelines/architecture.md): Backend/frontend structure
- [SEO Documentation](/docs/SEO.md): Sitemap, meta tags, prerendering strategy