{"id":25022165,"url":"https://github.com/waynesutton/promptstack","last_synced_at":"2025-08-20T16:06:13.975Z","repository":{"id":275074157,"uuid":"924523538","full_name":"waynesutton/promptstack","owner":"waynesutton","description":"A searchable collection of AI prompts and code gen cursor rules, for bolt.new, loveable, windsurf, trae, to enhance your workflow for developers.","archived":false,"fork":false,"pushed_at":"2025-05-28T15:08:59.000Z","size":13690,"stargazers_count":50,"open_issues_count":0,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-24T14:04:39.925Z","etag":null,"topics":["ai","prompt-engineering","prompts"],"latest_commit_sha":null,"homepage":"https://promptstack.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waynesutton.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-30T06:55:18.000Z","updated_at":"2025-06-20T02:22:50.000Z","dependencies_parsed_at":"2025-02-15T18:26:06.419Z","dependency_job_id":"f8a577b3-a497-4716-b388-21d8e1dca16d","html_url":"https://github.com/waynesutton/promptstack","commit_stats":null,"previous_names":["waynesutton/promptstack"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/waynesutton/promptstack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waynesutton%2Fpromptstack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waynesutton%2Fpromptstack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waynesutton%2Fpromptstack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waynesutton%2Fpromptstack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waynesutton","download_url":"https://codeload.github.com/waynesutton/promptstack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waynesutton%2Fpromptstack/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262978710,"owners_count":23394014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","prompt-engineering","prompts"],"created_at":"2025-02-05T13:53:45.749Z","updated_at":"2025-07-01T14:09:02.224Z","avatar_url":"https://github.com/waynesutton.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PromptStack - The CRM for Prompts, Vibe Coding, and Custom Rules.\n\n**[PromptStack](https://promptstack.dev)** 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.\n\n## Features\n\n- **Modern Interface**: Clean, compact design with improved user experience and streamlined workflows\n- **Searchable Directory**: Quickly find AI prompts and code generation rules tailored to your needs\n- **Prompt Likes**: Like and sort top prompts in the directory\n- **Category Organization**: Prompts are organized into clear, functional categories\n- **Custom Categories**: Create your own personal categories for better organization\n- **GitHub Integration**: Automatically link GitHub or social profiles submitted with prompts\n- **Carbon Copy View**: View and copy prompts in a Carbon-style editor window\n- **README Support**: Find and submit README examples for AI and code generation projects\n- **Cursor Rules**: Find and submit Cursor rules for AI and code generation projects\n- **Prompt Link Sharing**: Easily share prompts or cursor rules with others\n- **Rich Comments**: Comment on prompts with rich text formatting using TipTap editor\n- **Privacy Controls**: Create public prompts for the community or private prompts for personal use\n- **Edit \u0026 Delete**: Full control over your own prompts with edit and delete functionality\n- **Keyboard Shortcuts**: Efficient navigation with ESC to close modals and Ctrl/Cmd+Enter to submit forms\n\n---\n\n## Getting Started\n\n### Submit a Prompt\n\n1. Sign in with Clerk authentication or use the guest submission feature\n2. Fill out the required fields in our streamlined form:\n   - Title (Required)\n   - Prompt content\n   - Optional: Description, GitHub or social profile links\n3. Choose whether to make the prompt public or private\n4. Select from existing categories or create your own custom category\n5. Submit and share with the community\n\n### Search for Prompts\n\n- Browse the directory by categories such as Cursor, Convex, or README examples\n- Use the search bar to find prompts tailored to your specific framework or language\n- Filter by categories in the sidebar to narrow down results\n- Like prompts to save them for later reference\n\n### Customize Your Experience\n\n- Filter by \"My Prompts\" to view only your submissions\n- Create custom categories for better personal organization\n- Edit your prompts anytime with the built-in compact editor\n- Toggle prompts between public and private visibility\n\n## Development Roadmap\n\n### Completed Features ✅\n\n- ✅ Setup sign-in with Clerk authentication\n- ✅ Add a \"prompt feedback / comments\" section to each prompt page\n- ✅ Private prompts visible only to the creator\n- ✅ Public prompts visible to all users\n- ✅ Only allow prompt feedback or comments if user is logged in\n- ✅ Use [Minimal TipTap](https://shadcn-minimal-tiptap.vercel.app/) for prompt feedback / comments\n- ✅ Allow logged in users to like prompts and view liked prompts\n- ✅ Allow prompts to be editable only by their creators if they are logged in\n- ✅ Custom categories for personalized organization\n- ✅ Category management with add/delete functionality\n- ✅ Proper access control for private prompts\n- ✅ Shared PromptForm component for consistent UX\n- ✅ Modern, compact UI design with improved spacing and typography\n- ✅ Enhanced keyboard navigation and accessibility features\n\n---\n\n## Tech Stack\n\n**PromptStack** is powered by:\n\n**[Convex.dev](https://convex.link/promptstackgithub)**  \nConvex.dev provides a real-time database and backend that makes building reactive applications easy. It supports real-time updates, ensuring a seamless user experience.\n\n- Learn more about Convex:\n  - [Understanding Convex](https://docs.convex.dev/understanding/)\n  - [Best Practices](https://docs.convex.dev/understanding/best-practices/)\n  - [TypeScript Support](https://docs.convex.dev/understanding/best-practices/typescript)\n\n### Frontend Stack\n\n- [React 18](https://react.dev/) - Modern React with hooks and concurrent features\n- [TypeScript](https://www.typescriptlang.org/) - JavaScript with syntax for types\n- [TanStack Router](https://tanstack.com/router/latest/docs/framework/react/overview) - Type-safe client-side routing\n- [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS framework with custom design system\n- [Vite](https://vitejs.dev/) - Fast build tool and development server\n\n### Backend \u0026 Services\n\n- [Convex.dev](https://docs.convex.dev/) - Real-time database and backend with automatic synchronization\n- [Clerk](https://clerk.com/) - Authentication and user management\n- [Netlify](https://netlify.com) - Static site hosting and deployment\n\n### Development Tools\n\n- [Bun](https://bun.sh/) - JavaScript runtime \u0026 package manager\n- [ESLint](https://eslint.org/) - Code quality enforcement\n- [TipTap](https://tiptap.dev/) - Rich text editor for comments\n\n## Project Structure\n\n```\npromptstack/\n├── src/                          # Source code\n│   ├── components/               # React components\n│   │   ├── ui/                   # Reusable UI components\n│   │   ├── Header.tsx            # Navigation header with search\n│   │   ├── Footer.tsx            # Site footer with prompt count\n│   │   ├── PromptForm.tsx        # Modern, compact shared form component\n│   │   ├── CodeBlock.tsx         # Code syntax highlighting\n│   │   ├── CodeEditor.tsx        # Code editing component\n│   │   ├── CommentSection.tsx    # Prompt comments system\n│   │   ├── NotFound.tsx          # 404 component for access control\n│   │   └── minimal-tiptap.tsx    # Rich text editor\n│   ├── routes/                   # TanStack Router pages\n│   │   ├── index.tsx             # Home page redirect\n│   │   ├── addnew.tsx            # Add prompt form\n│   │   ├── prompt.$slug.tsx      # Individual prompt page\n│   │   ├── docs.tsx              # Documentation\n│   │   ├── about.tsx             # About page\n│   │   ├── prompt-guide.tsx      # Prompt creation guide\n│   │   └── 404.tsx               # 404 error page\n│   ├── constants/                # Application constants\n│   │   └── categories.ts         # Predefined categories\n│   ├── lib/                      # Utilities and types\n│   │   ├── utils.ts              # Helper functions\n│   │   └── types.ts              # TypeScript definitions\n│   ├── App.tsx                   # Main application component\n│   ├── main.tsx                  # Application entry point\n│   ├── router.ts                 # Router configuration\n│   └── ThemeContext.tsx          # Theme management\n├── convex/                       # Backend (Convex.dev)\n│   ├── schema.ts                 # Database schema\n│   ├── prompts.ts                # Prompt queries/mutations\n│   ├── comments.ts               # Comment system functions\n│   └── auth.config.ts            # Authentication config\n├── public/                       # Static assets\n│   ├── promptstacklogo.svg       # Main logo\n│   ├── favicon.svg               # Site favicon\n│   ├── og-image.png              # Social sharing image\n│   └── fonts/                    # Custom fonts\n├── package.json                  # Dependencies and scripts\n├── vite.config.ts                # Vite configuration\n├── tailwind.config.js            # Tailwind CSS config\n├── tsconfig.json                 # TypeScript configuration\n├── files.md                      # Detailed file documentation\n└── changelog.md                  # Development changelog\n```\n\nFor detailed information about each file and directory, see [`files.md`](./files.md).\n\n## Key Features\n\n### Authentication \u0026 User Management\n\n- **Clerk Integration**: Secure sign-in/sign-up with social providers\n- **User Profiles**: Persistent user identity and session management\n- **Access Control**: Proper permissions for editing and viewing prompts\n\n### Prompt Management\n\n- **CRUD Operations**: Create, read, update, and delete prompts with modern, compact interface\n- **Ownership Validation**: Users can only modify their own content\n- **Privacy Controls**: Toggle between public and private visibility\n- **Custom Categories**: Create personalized categories for organization\n\n### Modern User Experience\n\n- **Compact Design**: Streamlined, space-efficient interface with improved visual hierarchy\n- **Real-time Updates**: Live synchronization with Convex database\n- **Responsive Design**: Mobile-first design that works on all devices\n- **Dark/Light Theme**: Theme switching with persistent preferences\n- **Rich Text Editing**: TipTap editor for comments and descriptions\n- **Keyboard Shortcuts**: ESC to close modals, Ctrl/Cmd+Enter to submit forms\n\n### Search \u0026 Discovery\n\n- **Full-text Search**: Find prompts by title, content, or description\n- **Category Filtering**: Browse by predefined or custom categories\n- **Like System**: Community-driven prompt ranking\n- **Social Features**: Comments and engagement on prompts\n\n### Developer Tools\n\n- **Carbon Copy View**: View prompts in a Carbon-style code editor\n- **Syntax Highlighting**: Code blocks with proper syntax highlighting\n- **Export Functionality**: Easy copying and sharing of prompt content\n- **API Integration**: Built for integration with AI development tools\n\n## Installation\n\nClone the repository and install dependencies:\n\n```bash\ngit clone https://github.com/waynesutton/PromptStack\ncd PromptStack\nbun install\n```\n\nSet up environment variables in `.env.local`:\n\n```bash\n# Convex\nVITE_CONVEX_URL=your_convex_deployment_url\n\n# Clerk\nVITE_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key\n```\n\nStart the development server:\n\n```bash\nbun run dev\n```\n\n## Contributing\n\nWe welcome contributions from the community! Feel free to submit a pull request or open an issue to report bugs, suggest features, or provide feedback.\n\n## License\n\nThis project is licensed under the MIT License. See the `LICENSE` file for details.\n\n---\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/f6a1c7ac-d77a-4c43-92f9-7e8ca585c0d6/deploy-status)](https://app.netlify.com/sites/promptstack/deploys)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaynesutton%2Fpromptstack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaynesutton%2Fpromptstack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaynesutton%2Fpromptstack/lists"}