✨ NotePrompt

AI Prompt Management Platform

A modern, full-stack AI prompt management platform with multi-model optimization, community prompt library, and professional-grade editing tools.

Live Demo · Documentation · Report Bug

---

📖 Overview

NotePrompt is a production-ready AI prompt management platform built with Next.js 15. It provides a comprehensive workspace for creating, organizing, optimizing, and sharing AI prompts across multiple AI providers. Designed for both individual users and teams, it features a dual-mode editor, 17+ AI model integrations, a community-driven public prompt library with 15 curated categories, and a full admin dashboard.

🌐 Live at noteprompt.cn — Deployed on Alibaba Cloud with Docker, Nginx reverse proxy, and SSL.

Portfolio Highlights

• Local revision includes the opt-in /optimizer workspace, attachment text extraction (text, PDF, DOCX, spreadsheets and image OCR), bilingual UI settings and provider diagnostics.

• Set NEXT_PUBLIC_ENABLE_PROMPT_OPTIMIZER_V2=true before building to enable the new workspace. Provider settings and paid diagnostic probes require administrator authentication; attachment parsing requires sign-in.

• See source-sync verification and deployment limits before deploying this revision.

• Built as a complete SaaS-style product rather than a single-page demo: authentication, personal workspace, public library, admin dashboard, deployment scripts, and production reverse proxy are all included.

• Designed around a real prompt-management workflow: users can draft, organize, optimize, publish, search, and reuse prompts across multiple model providers.

• Shows full-stack engineering range: Next.js App Router, TypeScript, MySQL, Redis, JWT auth, Docker Compose, Nginx, email verification, and rate limiting.

• Useful as a portfolio project because it demonstrates product thinking, backend API design, AI-provider integration, and deployable infrastructure in one repository.

---

🎯 Key Features

Prompt Management

• Dual-Mode Editor — Switch between Standard and Professional editing modes with real-time preview
• Folder Organization — Hierarchical folder system with drag-and-drop, custom descriptions, and nested structure
• Version History — Automatic edit tracking with one-click rollback to any previous version
• Global Search — Ctrl+K instant search across all prompts and folders
• Tags & Categories — Organize prompts with 15 built-in categories and custom tagging

AI-Powered Optimization

• 17+ AI Models — Integrated with DeepSeek (V3.2, R1), Kimi (K2.5, K2 Thinking), Qwen (3.5 Plus, 3 Max, Coder Plus), Zhipu GLM (5, 4.7, 4.6, 4.5)
• Multi-Turn Optimization — Iterative prompt refinement through AI-guided conversations
• Model Presets — Creative / Balanced / Precise temperature presets for different use cases
• Auto-Fallback — Seamless failover between providers if one is unavailable

Community & Sharing

• Public Prompt Library — Browse, search, and collect community-shared prompts
• 15 Curated Categories — Writing, Programming, Education, Marketing, Creative Design, Data Analysis, Life Assistant, Translation, Productivity, AI Art, Academic Research, Social Media, Role-Playing, Content Creation, and more
• Favorites & Likes — Save and engage with the best community prompts
• One-Click Publish — Share your prompts to the public library instantly

Platform Features

• Dark Mode — Light / Dark / System-following theme with smooth transitions
• Admin Dashboard — Full platform management: user management, content moderation, usage statistics, featured content curation
• JWT Authentication — Secure registration/login with bcrypt password hashing (12 rounds)
• Email Verification — Optional email verification with rate-limited, brute-force-protected verification codes
• Rate Limiting — Redis-backed rate limiting on all sensitive endpoints
• Responsive Design — Fully optimized for desktop, tablet, and mobile

---

🛠 Tech Stack

Layer	Technology
Frontend	Next.js 15, React 18, TypeScript, Tailwind CSS 4
UI Components	shadcn/ui, Radix UI, Lucide Icons
Backend	Next.js App Router API Routes (Node.js)
Database	MySQL 8.0
Caching	Redis 7
Authentication	JWT + bcrypt
Email	Nodemailer
AI Providers	DeepSeek, Kimi (Moonshot), Qwen (DashScope), Zhipu GLM
Deployment	Docker Compose + Nginx + SSL

---

🚀 Getting Started

Prerequisites

• Node.js 24 (the verified runtime and Docker base)
• MySQL >= 8.0
• Redis >= 6 (optional, for rate limiting)
• At least one AI provider API key

1. Clone the Repository

git clone https://github.com/computersciencefreshmen/NotePrompt.git
cd NotePrompt

2. Install Dependencies

npm install

3. Configure Environment Variables

cp .env.example .env.local

Edit .env.local with your configuration:

# ── Database ─────────────────────────────────
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=agent_report

# ── Authentication ───────────────────────────
JWT_SECRET=your_jwt_secret_at_least_32_chars

# ── Redis (optional) ────────────────────────
REDIS_HOST=localhost
REDIS_PORT=6379

# ── AI API Keys (configure at least one) ────
DEEPSEEK_API_KEY=sk-xxx
KIMI_API_KEY=sk-xxx
QWEN_API_KEY=sk-xxx
ZHIPU_API_KEY=xxx.xxx

# ── Email (optional) ────────────────────────
SMTP_HOST=smtp.example.com
SMTP_PORT=465
SMTP_USER=your_email@example.com
SMTP_PASS=your_password
ENABLE_EMAIL_VERIFICATION=false

4. Initialize Database

mysql -u root -p agent_report < database/mysql-schema-new.sql

5. Start Development Server

npm run dev

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

---

🐳 Docker Deployment

Deploy the full stack (App + MySQL + Redis + Nginx) with a single command:

# 1. Configure production environment
cp .env.example .env.production

# 2. Launch all services
docker-compose up -d

# 3. Access the application
# → http://localhost (or your domain)

The Docker Compose stack includes:

• note-prompt-app — Next.js application (port 3001)
• docker_mysql8 — MySQL 8.0 with persistent volume
• note-prompt-redis — Redis 7 for caching and rate limiting
• note-prompt-nginx — Nginx reverse proxy with SSL termination

---

📁 Project Structure

NotePrompt/
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── page.tsx            #   Landing page
│   │   ├── admin/              #   Admin dashboard
│   │   ├── api/v1/             #   RESTful API routes
│   │   │   ├── auth/           #     Authentication (register, login, verify-email)
│   │   │   ├── ai/             #     AI optimization endpoints
│   │   │   ├── prompts/        #     User prompts CRUD
│   │   │   ├── public-prompts/ #     Public prompt library
│   │   │   ├── folders/        #     Folder management
│   │   │   ├── favorites/      #     Favorites system
│   │   │   ├── search/         #     Global search
│   │   │   └── tags/           #     Tag management
│   │   ├── prompts/            #   Prompt workspace pages
│   │   ├── public-prompts/     #   Public library pages
│   │   ├── folders/            #   Folder view pages
│   │   └── settings/           #   User settings
│   ├── components/             # Reusable React components
│   │   ├── ui/                 #   shadcn/ui base components
│   │   ├── AIOptimizeDialog.tsx #   AI optimization dialog
│   │   ├── Header.tsx          #   Navigation header
│   │   └── ...                 #   40+ components
│   ├── config/
│   │   └── ai.ts               # AI provider & model configuration
│   ├── contexts/               # React Context providers
│   │   ├── AuthContext.tsx      #   JWT authentication state
│   │   └── ThemeContext.tsx     #   Theme management
│   ├── hooks/                  # Custom React hooks
│   ├── lib/                    # Utilities & services
│   │   ├── mysql-database.ts   #   Database access layer
│   │   ├── rate-limit.ts       #   Rate limiting
│   │   └── email-service.ts    #   Email service
│   └── types/                  # TypeScript type definitions
├── database/
│   ├── mysql-schema-new.sql    # Full database schema
│   └── migrations/             # SQL migrations
├── nginx/
│   └── nginx.conf              # Nginx config (Cloudflare-ready)
├── docker-compose.yml          # Docker Compose orchestration
├── Dockerfile                  # Multi-stage production build
└── package.json

---

🔌 API Reference

All API endpoints are prefixed with /api/v1/.

Method	Endpoint	Description
POST	/auth/register	Register a new account
POST	/auth/login	Login and receive JWT token
POST	/auth/verify-email	Verify email with 6-digit code
GET	/prompts	List user's prompts
POST	/prompts	Create a new prompt
PUT	/prompts/:id	Update a prompt
DELETE	/prompts/:id	Delete a prompt
GET	/public-prompts	Browse public prompt library
POST	/public-prompts	Publish a prompt
GET	/folders	List user's folders
POST	/folders	Create a new folder
POST	/ai/optimize	AI-powered prompt optimization
GET	/search	Global search
GET	/favorites	List favorites
POST	/favorites	Add to favorites
GET	/categories	List all categories
GET	/tags	List all tags

---

🤖 Supported AI Models

Provider	Models	Highlights
DeepSeek	V3.2 Chat, R1 (Reasoner)	Top-tier reasoning capability
Kimi (Moonshot)	K2.5, K2 Thinking, Moonshot V1 (32K/128K)	128K context window
Qwen (Alibaba)	3.5 Plus, 3 Max, Coder Plus, Long, 3.5 Flash	Best Chinese language support
Zhipu GLM	GLM-5, GLM-4.7, GLM-4.7-Flash, GLM-4.6, GLM-4.5	128K context, up to 131072 tokens

---

🔒 Security

• Password Hashing — bcrypt with 12 salt rounds (OWASP recommended)
• JWT Authentication — Secure token-based auth with httpOnly cookies
• Rate Limiting — Redis-backed rate limiting on auth and API endpoints
• Input Validation — Server-side validation on all user inputs
• CSRF Protection — SameSite cookie policy
• Brute Force Protection — Lockout after 5 failed verification attempts
• Timing-Safe Comparison — crypto.timingSafeEqual for verification codes

---

📸 Screenshots

📌 Screenshots coming soon — visit noteprompt.cn for the live experience.

---

📄 License

This project is licensed under the MIT License.

---

Built with ❤️ using Next.js, TypeScript, and Tailwind CSS

⬆ Back to Top