Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Prompt Saver

✓ vom Dienst · promptsaver.online

von VeshRaazThapaVersion 1.0.0i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registryonline.promptsaver/prompt-saver

So installierst du es

What it does

Your versioned prompt library: search, read, save and version prompts from Claude Code.

  • Connects Läuft in der Cloud
  • Account or key Needs Authorization
  • Category Suche & KI-Gedächtnis

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

von google-research★ 35.6291 Skills

Skill · Anleitung

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

von BigBodyCobain★ 11.6021 Skills

Skill · Anleitung

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

von gosom★ 8.2091 Skills

Skill · Anleitung

Warum es hier steht

Dieser Eintrag steht im Tab „Apps, die sich mit KI verbinden“, der ohne Sterne in dieser Reihenfolge sortiert

1. In Claudes Connector-VerzeichnisNein
2. Vom Team getestetNein
3. Für Nutzer in Thailand geeignetNein
4. Nutzung ohne Sterne20/100Beliebtheit 0 · Aktualität 12 · Antwortet noch 8 · Likes von Nutzern +0
5. Eingetragen am2026-11-01

Likes von Nutzern: 0 · Höchstens 5 Punkte (1 pro Person). Nicht käuflich.

Qualität: 4/4 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Prompt Saver. Folge https://mcp.popnx.com/i/online-promptsaver-prompt-saver.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/4 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (promptsaver.online) · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 5 Min.

Du brauchst einen Schlüssel von Prompt Saver (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei Prompt Saver registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Prompt Saver öffnen ↗

  2. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NamePrompt Saver
    Remote MCP server URL · Adressehttps://promptsaver.online/api/mcp

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-NameAuthorization
    WertBearer <Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  4. Im Chat einschalten

    +ConnectorsPrompt Saver

  5. Ausprobieren

    Nutze Prompt Saver und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Prompt Saver nutzt, oder ein Werkzeug von Prompt Saver in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Prompt Saver noch nicht verbinden

Prompt Saver braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die Prompt Saver verbinden kann

  • Du brauchst einen Schlüssel von Prompt Saver (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von Prompt Saver (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Prompt Saver (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Prompt Saver (auf der Seite des Anbieters erstellen)

B · Andere in Suche & KI-Gedächtnis, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code · etwa 5 Min.

Du brauchst einen Schlüssel von Prompt Saver (auf der Seite des Anbieters erstellen)

  1. Bei Prompt Saver registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Prompt Saver öffnen ↗

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user prompt-saver https://promptsaver.online/api/mcp --header 'Authorization: Bearer your-value'

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    Prompt Saver sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze Prompt Saver und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Prompt Saver nutzt, oder ein Werkzeug von Prompt Saver in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 5 Min.

Du brauchst einen Schlüssel von Prompt Saver (auf der Seite des Anbieters erstellen)

  1. Bei Prompt Saver registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Prompt Saver öffnen ↗

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Prompt Saver ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Prompt Saver und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Prompt Saver nutzt, oder ein Werkzeug von Prompt Saver in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 5 Min.

Du brauchst einen Schlüssel von Prompt Saver (auf der Seite des Anbieters erstellen)

  1. Bei Prompt Saver registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Prompt Saver öffnen ↗

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Prompt Saver ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Prompt Saver und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Prompt Saver nutzt, oder ein Werkzeug von Prompt Saver in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://promptsaver.online/api/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Prompt Saver nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user prompt-saver https://promptsaver.online/api/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "prompt-saver": {
      "url": "https://promptsaver.online/api/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "prompt-saver": {
      "type": "http",
      "url": "https://promptsaver.online/api/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • Authorization geheim erforderlich HTTP header
    Bearer token from Settings at https://promptsaver.online (format: Bearer ps_...)

Die Beschreibungen sind noch im englischen Original.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Bestätigte Domain
✓ promptsaver.online
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.0.0
In der Registry veröffentlichti
1. Nov. 2026
Code zuletzt geänderti
12. Nov. 2026
Zuletzt geprüft
17. Nov. 2026
Entwickler
VeshRaazThapa
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde über die Domain promptsaver.online bestätigt (die Registry prüft, wem die Domain gehört)

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 7 Tagen

  • – Nicht zutreffend

    Hat eine Lizenz

    Nicht relevant: Cloud-Server des Inhabers von promptsaver.online; du führst keinen Code aus dem Repo aus

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 566 ms (HTTP 401)

  • ✓ Bestanden

    Anmeldung mit OAuth

    Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/online-promptsaver-prompt-saver.svg)](https://mcp.popnx.com/en/servers/online-promptsaver-prompt-saver)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Suche & KI-Gedächtnisi

  • Mehr Sterne als 0 % der anderen 6394 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 69 % der anderen 6394 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 6394 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Prompt Saver sicher?

Er hat 4 von 4 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: Authorization

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 7 Tagen geändert, und die neueste Version (1.0.0) kam vor 18 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

von every-appWeit verbreitet★ 28.166Aktualisiert vor 5 Tagen

Läuft in der Cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

von exa-labsWeit verbreitet★ 5242Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · exa.aiVom PopNx-Team ausprobiert

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

von MicrosoftDocsWeit verbreitet★ 1997Aktualisiert vor 12 Monaten

Läuft in der Cloud✓ vom Dienst · microsoft.comVom PopNx-Team ausprobiert

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

von proxysoulWachsend★ 1626Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ empryo.com

COTAL actions (cotal.ai)

cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls

von Cotal-AIWachsend★ 399Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · cotal.ai
Im Vergleich mit ähnlichen
Dieser
Prompt Saver
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaJaJaNeinNein
Basisprüfungen4/45/52/44/44/44/4
LizenzMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Prompt Saver - LLM Prompt Intelligence Platform

Live: https://promptsaver.online/

Chrome extension: Add to Chrome — type // in Claude, ChatGPT or Gemini to insert a saved prompt.

A prompt management tool for saving, versioning, and searching LLM prompts. Built with Next.js, Neon Postgres, and a warm stone/teal design system.

Features (MVP - Phase 1)

  • Prompt Authoring: Create and edit prompts with automatic versioning
  • Multi-LLM Testing: Execute prompts against multiple LLM providers from a single interface
  • Prompt Library: Full-text search and intelligent categorization of prompts
  • Workspace-Based Organization: Organize prompts within dedicated workspaces

MCP Server (Claude Code Integration)

Prompt Saver runs a remote MCP server at /api/mcp, so a Claude Code session can search, read, and save your prompts without leaving the terminal.

Connect
  1. Sign in at https://promptsaver.online/, then click Settings and generate a token. The raw token is shown exactly once — copy it immediately. Only its SHA-256 hash is stored, so a lost token can't be recovered; revoke it on the same page and create a new one.
  2. The tokens page shows the registration command with your token filled in. It looks like:
   claude mcp add --transport http prompt-saver --scope user \

https://promptsaver.online/api/mcp \ --header "Authorization: Bearer ps_..."

--scope user registers the server once for every project rather than just the current one.

Tools

Once connected, Claude Code can call five tools against your prompt library:

  • search_prompts(query, limit?) — searches title, description, content and tags. Returns summaries only (id, title, description, tags, updated_at) — never full bodies. limit defaults to 20 and is capped at 50.
  • get_prompt(id) — fetches the full text of one prompt.
  • create_prompt(title, content, description?, tags?) — saves a new prompt along with its first version.
  • update_prompt(id, ...) — updates a prompt's draft in place, without creating a new version.
  • save_version(id, content, change_summary?) — saves an immutable new version of an existing prompt.

There is no delete tool.

Favourite prompts as slash commands

Any prompt marked as a favourite (the star in the web app) is also registered as a slash command, named from its title — "Daily Planning" becomes /mcp__prompt-saver__daily-planning. Archived favourites are excluded. Each command takes one optional context argument, appended to the prompt body:

/mcp__prompt-saver__daily-planning auth refactor

Favourites are read once, when the session connects. Starring a prompt does not add its slash command to a session that's already running — open a new session, or run /mcp to reconnect, to pick up newly starred prompts.

Cold starts

The database backing this app (Neon Postgres) scales its compute to zero when idle. The first MCP request after a period of inactivity may take noticeably longer while it wakes back up; subsequent requests are fast.

Chrome extension

The Chrome extension lives in extension/. It lets users save prompts from any webpage or AI chat interface.

Setup and development
cd extension

npm install npm run dev

The development build is unpacked and ready to load into Chrome. Configuration requires the web app's NEXT_PUBLIC_EXTENSION_IDS environment variable to contain the extension's ID (visible in chrome://extensions/ when unpacked). Set it to * to allow any well-formed extension ID. That's useful while unpacked IDs change, but any extension can then ask a signed-in user to connect (the connect page shows the requesting ID), so use an explicit list in production.

API

The extension calls these endpoints on the web app's /api/v1/prompts route:

MethodPathPurposeHeaders
GET/api/v1/promptsList prompts. Accepts ?q= &limit= (limit ≤200).Authorization: Bearer ps_
POST/api/v1/promptsCreate a new prompt.Authorization: Bearer ps_
GET/api/v1/prompts/:idFetch a single prompt by ID.Authorization: Bearer ps_
PATCH/api/v1/prompts/:idUpdate a prompt.Authorization: Bearer ps_

All endpoints require a bearer token prefixed with ps_.

For privacy details, see /privacy.

Technology Stack

  • Frontend: Next.js 16, React 18, TypeScript (strict mode)
  • Styling: Tailwind CSS (WCAG 2.1 AA accessible)
  • Storage: Neon Postgres via Drizzle ORM (server-side, per-user isolated)
  • Authentication: Google OAuth via NextAuth.js
  • Testing: Jest + React Testing Library
  • Code Quality: ESLint, Prettier, TypeScript strict mode

Prerequisites

  • Node.js 18.17+ or 20.x
  • npm 9+ (or use npm ci with --legacy-peer-deps)

Setup

1. Clone and Install
git clone <repository-url>

cd prompt-saver npm install --legacy-peer-deps

2. Configure Environment Variables

Create .env.local based on .env.example:

cp .env.example .env.local

Required variables:

NEXTAUTH_SECRET=your-secret-key-here

NEXTAUTH_URL=http://localhost:3000 GOOGLE_CLIENT_ID=your-google-client-id GOOGLE_CLIENT_SECRET=your-google-client-secret DATABASE_URL=postgresql://...-pooler.../neondb?sslmode=require DATABASE_URL_UNPOOLED=postgresql://.../neondb?sslmode=require ALLOWED_EMAILS=you@example.com

Warning: leaving ALLOWED_EMAILS unset lets anyone with a Google account sign in and get their own workspace. Always set it to a comma-separated allowlist of emails before deploying anywhere reachable.

3. Run Development Server
npm run dev

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

Development

Scripts
# Start development server

npm run dev

Build for production

npm run build

Run production server

npm start

Run tests

npm run test npm run test:watch # Watch mode npm run test:coverage # With coverage

Linting

npm run lint npm run lint:fix

Code formatting

npm run format npm run format:check

Type checking

npm run type-check

Project Structure
src/

├── app/ # Next.js App Router pages and layouts ├── components/ # React components ├── lib/ # Utilities, hooks, services, and business logic │ ├── api/ # API response wrappers │ ├── auth/ # Authentication logic │ ├── db/ # Database repositories and schemas │ ├── hooks/ # Custom React hooks │ ├── services/ # Business logic services │ └── utils/ # Helper utilities └── types/ # TypeScript type definitions

tests/ ├── unit/ # Unit tests for utilities and hooks ├── integration/ # Integration tests └── contract/ # API contract tests

Code Quality Standards

TypeScript Strict Mode
  • No any types without justification
  • All implicit returns must be typed
  • Strict null checking enabled
  • Strict property initialization required
ESLint Rules
  • 80%+ test coverage for all utilities and hooks
  • Maximum function complexity: 10 cyclomatic points
  • No console statements in production code (warning only)
  • No unused variables or imports
Testing Requirements
  • All utilities must have unit tests
  • All components must have integration tests
  • API routes must have contract tests
  • TDD approach: write tests first, must fail before implementation

Performance Targets

  • Core Web Vitals: LCP ≤2.5s, FID ≤100ms, CLS ≤0.1
  • Version creation: <100ms (atomic)
  • Search response: <200ms for 10k prompts
  • API response time (p95): <200ms
  • Concurrent LLM executions: 100+ parallel

Accessibility

  • WCAG 2.1 AA compliance
  • Responsive design (320px to 1920px+)
  • Keyboard navigation support
  • Screen reader friendly components

Deployment

Build
npm run build
Environment Variables (Production)

Set these in your deployment platform:

NEXTAUTH_SECRET=<generate-with-: openssl rand -base64 32>

NEXTAUTH_URL=https://your-production-domain.com GOOGLE_CLIENT_ID=your-google-client-id GOOGLE_CLIENT_SECRET=your-google-client-secret DATABASE_URL=postgresql://...-pooler.../neondb?sslmode=require DATABASE_URL_UNPOOLED=postgresql://.../neondb?sslmode=require ALLOWED_EMAILS=you@example.com

Warning: leaving ALLOWED_EMAILS unset lets anyone with a Google account sign in and get their own workspace. Do not skip it.

CI/CD

GitHub Actions automatically runs on push and pull requests:

  • TypeScript type checking
  • ESLint linting
  • Prettier formatting
  • Jest test suite
  • Next.js build verification

Tests must pass before merging to main branch.

Contributing

  1. Create a feature branch from 001-prompt-platform
  2. Follow the TypeScript strict mode guidelines
  3. Write tests first (TDD approach)
  4. Ensure all tests pass: npm test
  5. Ensure linting passes: npm run lint
  6. Submit a pull request

Architecture Decisions

Repository Pattern

Database access is confined to repository classes implementing the interfaces in src/lib/db/repositories/types.ts. Server Actions are the only callers; client components never touch the database.

Immutable Versions

PromptVersions are immutable by design - no in-place edits allowed. This enables clean audit trails and version history.

Workspace Isolation

Every user gets one private workspace, created on first sign-in. All queries are scoped to the workspace id returned by getCurrentContext() — never to a value supplied by the client.

Roadmap

  • Phase 2: Foundational infrastructure (database, auth, API patterns)
  • Phase 3: User Story 1 - Prompt Authoring & Versioning
  • Phase 4: User Story 2 - Multi-LLM Execution & Testing
  • Phase 5: User Story 3 - Prompt Library & Search
  • Phase 6: User Story 4 - Collaboration & Sharing
  • Phase 7: User Story 5 - Prompt Testing & Evaluation

License

MIT — see LICENSE.

Support

For issues or questions, please contact the development team.