Back to skills
promptstack
by waynesutton
WindsurfโNot yet rated
Your rating
Brief
A searchable collection of AI prompts and code gen cursor rules, for bolt.new, loveable, windsurf, trae, to enhance your workflow for developers.
Description
# PromptStack - The CRM for Prompts, Vibe Coding, and Custom Rules. > The hosted version at promptstack.dev is retired. The code stays here, open source, so you can run your own copy. See [Installation](#installation). **PromptStack** is a **open-source** real-time prompt management platform built with React, [Convex.dev](https://convex.link/promptstackgithub), and Clerk authentication. It enables users to create, organize, and share AI prompts with features like custom categories, privacy controls, and community engagement through likes and comments. The platform features a sleek, responsive design with both grid and list views, real-time updates, and comprehensive search and filtering capabilities. ## Features - **Modern Interface**: Clean, compact design with improved user experience and streamlined workflows - **Searchable Directory**: Quickly find AI prompts and code generation rules tailored to your needs - **Prompt Likes**: Like and sort top prompts in the directory - **Category Organization**: Prompts are organized into clear, functional categories - **Custom Categories**: Create your own personal categories for better organization - **GitHub Integration**: Automatically link GitHub or social profiles submitted with prompts - **Carbon Copy View**: View and copy prompts in a Carbon-style editor window - **README Support**: Find and submit README examples for AI and code generation projects - **Cursor Rules**: Find and submit Cursor rules for AI and code generation projects - **Prompt Link Sharing**: Easily share prompts or cursor rules with others - **Rich Comments**: Comment on prompts with rich text formatting using TipTap editor - **Privacy Controls**: Create public prompts for the community or private prompts for personal use - **Edit & Delete**: Full control over your own prompts with edit and delete functionality - **Keyboard Shortcuts**: Efficient navigation with ESC to close modals and Ctrl/Cmd+Enter to submit forms --- ## Getting Started ### Submit a Prompt 1. Sign in with Clerk authentication or use the guest submission feature 2. Fill out the required fields in our streamlined form: - Title (Required) - Prompt content - Optional: Description, GitHub or social profile links 3. Choose whether to make the prompt public or private 4. Select from existing categories or create your own custom category 5. Submit and share with the community ### Search for Prompts - Browse the directory by categories such as Cursor, Convex, or README examples - Use the search bar to find prompts tailored to your specific framework or language - Filter by categories in the sidebar to narrow down results - Like prompts to save them for later reference ### Customize Your Experience - Filter by "My Prompts" to view only your submissions - Create custom categories for better personal organization - Edit your prompts anytime with the built-in compact editor - Toggle prompts between public and private visibility ## Development Roadmap ### Completed Features โ - โ Setup sign-in with Clerk authentication - โ Add a "prompt feedback / comments" section to each prompt page - โ Private prompts visible only to the creator - โ Public prompts visible to all users - โ Only allow prompt feedback or comments if user is logged in - โ Use [Minimal TipTap](https://shadcn-minimal-tiptap.vercel.app/) for prompt feedback / comments - โ Allow logged in users to like prompts and view liked prompts - โ Allow prompts to be editable only by their creators if they are logged in - โ Custom categories for personalized organization - โ Category management with add/delete functionality - โ Proper access control for private prompts - โ Shared PromptForm component for consistent UX - โ Modern, compact UI design with improved spacing and typography - โ Enhanced keyboard navigation and accessibility features --- ## Tech Stack **PromptStack** is powered by: **[Convex.dev](https://convex.link/promptstackgithub)** Convex.dev provides a real-time database and backend that makes building reactive applications easy. It supports real-time updates, ensuring a seamless user experience. - Learn more about Convex: - [Understanding Convex](https://docs.convex.dev/understanding/) - [Best Practices](https://docs.convex.dev/understanding/best-practices/) - [TypeScript Support](https://docs.convex.dev/understanding/best-practices/typescript) ### Frontend Stack - [React 18](https://react.dev/) - Modern React with hooks and concurrent features - [TypeScript](https://www.typescriptlang.org/) - JavaScript with syntax for types - [TanStack Router](https://tanstack.com/router/latest/docs/framework/react/overview) - Type-safe client-side routing - [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS framework with custom design system - [Vite](https://vitejs.dev/) - Fast build tool and development server ### Backend & Services - [Convex.dev](https://docs.convex.dev/) - Real-time database and backend with automatic synchronization - [Clerk](https://clerk.com/) - Authentication and user management - [Netlify](https://netlify.com) - Static site hosting (example config in `netlify.toml`) ### Development Tools - [Bun](https://bun.sh/) - JavaScript runtime & package manager - [ESLint](https://eslint.org/) - Code quality enforcement - [TipTap](https://tiptap.dev/) - Rich text editor for comments ## Project Structure ``` promptstack/ โโโ src/ # Source code โ โโโ components/ # React components โ โ โโโ ui/ # Reusable UI components โ โ โโโ Header.tsx # Navigation header with search โ โ โโโ Footer.tsx # Site footer with prompt count โ โ โโโ PromptForm.tsx # Modern, compact shared form component โ โ โโโ CodeBlock.tsx # Code syntax highlighting โ โ โโโ CodeEditor.tsx # Code editing component โ โ โโโ CommentSection.tsx # Prompt comments system โ โ โโโ NotFound.tsx # 404 component for access control โ โ โโโ minimal-tiptap.tsx # Rich text editor โ โโโ routes/ # TanStack Router pages โ โ โโโ index.tsx # Home page redirect โ โ โโโ addnew.tsx # Add prompt form โ โ โโโ prompt.$slug.tsx # Individual prompt page โ โ โโโ docs.tsx # Documentation โ โ โโโ about.tsx # About page โ โ โโโ prompt-guide.tsx # Prompt creation guide โ โ โโโ 404.tsx # 404 error page โ โโโ constants/ # Application constants โ โ โโโ categories.ts # Predefined categories โ โโโ lib/ # Utilities and types โ โ โโโ utils.ts # Helper functions โ โ โโโ types.ts # TypeScript definitions โ โโโ App.tsx # Main application component โ โโโ main.tsx # Application entry point โ โโโ router.ts # Router configuration โ โโโ ThemeContext.tsx # Theme management โโโ convex/ # Backend (Convex.dev) โ โโโ schema.ts # Database schema โ โโโ prompts.ts # Prompt queries/mutations โ โโโ comments.ts # Comment system functions โ โโโ auth.config.ts # Authentication config โโโ public/ # Static assets โ โโโ promptstacklogo.svg # Main logo โ โโโ favicon.svg # Site favicon โ โโโ og-image.png # Social sharing image โ โโโ fonts/ # Custom fonts โโโ package.json # Dependencies and scripts โโโ vite.config.ts # Vite configuration โโโ tailwind.config.js # Tailwind CSS config โโโ tsconfig.json # TypeScript configuration โโโ files.md # Detailed file documentation โโโ changelog.md # Development changelog ``` For detailed information about each file and directory, see [`files.md`](./files.md). ## Key Features ### Authentication & User Management - **Clerk Integration**: Secure sign-in/sign-up with social providers - **User Profiles**: Persistent user identity and session management - **Access Control**: Proper permissions for editing and viewing prompts ### Prompt Management - **CRUD Operations**: Create, read, update, and delete prompts with modern, compact interface - **Ownership Validation**: Users can only modify their own content - **Privacy Controls**: Toggle between public and private visibility - **Custom Categories**: Create personalized categories for organization ### Modern User Experience - **Compact Design**: Streamlined, space-efficient interface with improved visual hierarchy - **Real-time Updates**: Live synchronization with Convex database - **Responsive Design**: Mobile-first design that works on all devices - **Dark/Light Theme**: Theme switching with persistent preferences - **Rich Text Editing**: TipTap editor for comments and descriptions - **Keyboard Shortcuts**: ESC to close modals, Ctrl/Cmd+Enter to submit forms ### Search & Discovery - **Full-text Search**: Find prompts by title, content, or description - **Category Filtering**: Browse by predefined or custom categories - **Like System**: Community-driven prompt ranking - **Social Features**: Comments and engagement on prompts ### Developer Tools - **Carbon Copy View**: View prompts in a Carbon-style code editor - **Syntax Highlighting**: Code blocks with proper syntax highlighting - **Export Functionality**: Easy copying and sharing of prompt content - **API Integration**: Built for integration with AI development tools ## Installation Clone the repository and install dependencies: ```bash git clone https://github.com/waynesutton/promptstack cd promptstack npm install ``` Create a Convex project. This writes `CONVEX_DEPLOYMENT` and `VITE_CONVEX_URL` to `.env.local`: ```bash npx convex dev --once ``` Add your Clerk publishable key to `.env.local`. It is the only Clerk value the browser needs: ```bash VITE_CLERK_PUBLISHABLE_KEY=pk_test_... ``` Create a JWT template named `convex` in the Clerk dashboard, then set its issuer URL on the Convex deployment. This is a server value, so it goes in Convex env, not `.env.local`: ```bash npx convex env set CLERK_ISSUER_URL https://your-instance.clerk.accounts.dev ``` Start the development server: ```bash npm run dev ``` Checks to run before you deploy: ```bash npm run lint # Convex lint rules, including access control on every public function npm test # convex-test suite for comment, like, rating, and ownership rules npm run build # typecheck and production build with the Content Security Policy ``` To deploy on Netlify, set `CONVEX_DEPLOY_KEY` in Site configuration, Environment variables, and use the build command in `netlify.toml`. ## Security - Report security issues privately through a GitHub security advisory. See [SECURITY.md](./SECURITY.md). - Never commit keys. `.env.local` is gitignored. Deploy keys go in your host dashboard, server secrets go in `npx convex env set`. - Anything prefixed `VITE_` ships to the browser. Only put the Convex URL and the Clerk publishable key there. ## Contributing We welcome contributions from the community! Feel free to submit a pull request or open an issue to report bugs, suggest features, or provide feedback. ## License This project is licensed under the MIT License. See the `LICENSE` file for details.
Installation
Install the skill from https://github.com/waynesutton/promptstackThis skill is not published on the ClawHub registry. Paste the prompt into your coding agent โ Claude Code, Cursor, Codex โ and it will install the skill straight from the source repository.
Open the repository