# Prompterly - Vollständige Dokumentation

## Was ist Prompterly?

Prompterly ist ein professionelles Multi-Plattform-Tool für Entwickler und Teams, die mit AI-Plattformen arbeiten. Es ermöglicht das Speichern, Organisieren und schnelle Einfügen von wiederkehrenden Prompts in Lovable.dev, ChatGPT und Claude. Die Anwendung ist vollständig mehrsprachig (Deutsch/Englisch) und bietet sowohl eine Web-App als auch eine Chrome-Extension.

## Unterstützte Plattformen

| Plattform | URL | Beschreibung |
|-----------|-----|--------------|
| Lovable.dev | lovable.dev | AI-gestützte Web-Entwicklung |
| ChatGPT | chat.openai.com, chatgpt.com | OpenAI Chat Interface |
| Claude | claude.ai | Anthropic Claude AI |

Die Extension erkennt automatisch die aktive Plattform und passt die Integration entsprechend an.

## Seitenstruktur

### Öffentliche Seiten

| Seite | URL | Beschreibung |
|-------|-----|--------------|
| Landing | / | Homepage mit Feature-Übersicht, Preisen und CTA |
| Extension | /extension | Chrome-Extension Download, Features und Installation |
| Bookmarklets | /bookmarklets | Browser-unabhängige Bookmarklet-Tools |
| Developers | /developers | Marktplatz für Lovable-Entwickler |
| Auth | /auth | Login und Registrierung |
| Impressum | /impressum | Rechtliche Informationen |

### Geschützte Seiten (Login erforderlich)

| Seite | URL | Beschreibung |
|-------|-----|--------------|
| Projects | /projects | Haupt-Dashboard für Prompt-Verwaltung |
| Dashboard | /dashboard/:projectId | Projekt-spezifisches Prompt-Management |
| Picker | /picker | Schnellauswahl-Widget für Prompts |
| Settings | /settings | Benutzereinstellungen |
| Profile | /profile/* | Profil- und Billing-Einstellungen |
| Customers | /customers | Kundenverwaltung für Entwickler |

## Hauptfunktionen

### 1. Projekt-Verwaltung

Erstelle separate Projekte für jede deiner Anwendungen:
- Benutzerdefinierte Namen und Beschreibungen
- Farbcodierung für schnelle Erkennung
- Icon-Auswahl oder Logo-Upload für visuelle Unterscheidung
- Prompt-Zähler und Fortschrittsanzeige
- Favoriten-Markierung
- Drag & Drop Sortierung
- Externe URL-Verknüpfung zum Projekt

### 2. Phasen-System

Kategorisiere deine Prompts nach Entwicklungsphasen:

- **Setup**: Projekt-Initialisierung und Grundkonfiguration
- **Auth**: Authentifizierung und Benutzerverwaltung
- **Database**: Datenbankschema und Migrations
- **Features**: Kernfunktionalitäten implementieren
- **UI/UX**: Design und Benutzeroberfläche
- **i18n**: Internationalisierung
- **Landing**: Landing Page und Marketing
- **Debug**: Fehlerbehebung und Debugging
- **Polish**: Feinschliff und Optimierung
- **Custom**: Benutzerdefinierte Phasen (projektspezifisch)

Jede Phase hat eine eigene Farbe und kann individuell konfiguriert werden.

### 3. Template-Variablen

Erstelle dynamische Prompts mit Variablen:

**Syntax:**
- `{{variableName}}` - Einfache Variable
- `{{name:Label}}` - Variable mit benutzerdefiniertem Label
- `{{name:Label:Standardwert}}` - Variable mit Default-Wert

**Beispiel:**
```
Erstelle eine {{componentType:Komponenten-Typ:Button}} Komponente 
namens {{componentName:Name}} mit {{color:Farbe:blue}} Styling.
```

Beim Einfügen öffnet sich ein Dialog zur Eingabe aller Variablen.

### 4. Browser Extension

Die Chrome-Extension (Manifest V3) bietet:
- **Multi-Plattform Support**: Lovable.dev, ChatGPT, Claude
- One-Click Prompt-Erfassung
- Schnelles Einfügen gespeicherter Prompts
- Template-Variablen-Dialog
- Kontextmenü-Integration
- Popup für schnellen Zugriff
- Auto-Send Option
- Chat-Mode Toggle
- Tastatur-Shortcuts (Ctrl+Shift+P, Ctrl+Shift+N)

**Installation:**
1. Extension von /extension herunterladen
2. In Chrome unter chrome://extensions laden
3. Entwicklermodus aktivieren
4. "Entpackte Erweiterung laden" wählen
5. Mit Prompterly-Account verbinden

### 5. Bookmarklets

Alternative zur Extension für alle Browser:
- Prompt-Picker öffnen
- Quick-Capture für neue Prompts
- Funktioniert in Chrome, Firefox, Safari, Edge
- Keine Installation erforderlich

### 6. Picker Widget

Das Picker-Widget ermöglicht:
- Schnelle Suche durch alle Prompts
- Filterung nach Projekt und Phase
- Status-Filter (Offen/Erledigt)
- Direktes Kopieren in die Zwischenablage
- Zuletzt verwendete Prompts
- Keyboard-Shortcuts
- Dark/Light Mode

### 7. Prompt-Features

Jeder Prompt unterstützt:
- Titel und Inhalt
- Phasen-Zuordnung
- Template-Variablen
- Auto-Send Option (automatisches Absenden)
- Chat-Mode Toggle
- Erledigt-Markierung
- Drag & Drop Sortierung
- Schnelle Bearbeitung
- Vorlagen-System

### 8. Ticket-System

Vollständiges Aufgabenmanagement für Teams:

**Features:**
- Tickets erstellen, bearbeiten, zuweisen
- Status-Workflow: Draft → Open → Accepted → In Progress → Completed
- Prioritäten und geschätzte Stunden
- Fälligkeitsdatum (planned_at)

**Kalender-Ansicht:**
- Monats-, Wochen- und Tagesansicht
- Drag & Drop zum Verschieben von Tickets
- Workload-Indikator (Stunden pro Tag)
- Farbcodierung nach Projekt

**Kommentare:**
- Kommentar-Thread pro Ticket
- @-Mentions für Team-Mitglieder
- E-Mail-Benachrichtigungen

**Ticket-zu-Prompt Konverter:**
- Tickets direkt in Prompts umwandeln
- Phase und Projekt auswählen

### 9. @-Mentions in Kommentaren

Erwähne Team-Mitglieder direkt in Ticket-Kommentaren:
- Tippe `@` für Autocomplete
- Keyboard-Navigation (↑/↓/Enter)
- Erwähnte User erhalten E-Mail-Benachrichtigung
- Mentions werden visuell hervorgehoben

### 10. Developer Marketplace

Der Entwickler-Marktplatz bietet:
- Profile von Lovable-Entwicklern
- Skills und Expertise anzeigen
- Direkte Kontaktaufnahme
- Stundensatz-Informationen
- Social Links (GitHub, LinkedIn, Twitter)
- Lead-Tracking für Entwickler

### 11. Kundenverwaltung

Für Entwickler mit mehreren Kunden:
- Kunden mit Logo und Farbe anlegen
- Kunden zu Projekten zuweisen
- Team-Mitglieder zu Kunden einladen
- Rollen: Owner, Admin, Member, Viewer
- Kundenanfragen verwalten

### 12. Credits & Pläne

**Credit-System:**
- AI-Features kosten Credits
- Monatliche Credits je nach Plan
- Zusätzliche Credits kaufbar
- Transaktions-Historie

**Verfügbare Pläne:**
- **Free**: Basis-Features, begrenzte Projekte
- **Pro**: Unbegrenzte Projekte, alle Features
- **Power**: Zusätzliche AI-Credits, Priority-Support

## API und Integration

Prompterly nutzt Supabase als Backend mit:
- Row Level Security für Datenschutz
- Echtzeit-Synchronisation
- Sichere Authentifizierung
- Edge Functions für Backend-Logik
- Stripe Integration für Payments

## Technischer Stack

- **Frontend**: React 18, TypeScript, Tailwind CSS
- **UI Components**: shadcn/ui, Radix UI
- **State Management**: TanStack Query
- **Drag & Drop**: dnd-kit
- **Backend**: Supabase (PostgreSQL)
- **Auth**: Supabase Auth
- **Payments**: Stripe Integration
- **i18n**: react-i18next
- **Deployment**: Lovable Platform

## Sicherheit

- Alle Daten sind benutzerspezifisch geschützt
- Row Level Security auf Datenbankebene
- Sichere HTTPS-Verbindung
- Keine Weitergabe von Daten an Dritte
- DSGVO-konform

## SEO und Discoverability

- Vollständige Meta-Tags (OG, Twitter)
- Strukturierte Daten (JSON-LD)
- Sitemap.xml
- robots.txt optimiert
- llms.txt für AI-Crawler
- Mehrsprachige Unterstützung

## Zielgruppe

- Lovable.dev, ChatGPT und Claude Nutzer
- Teams die mit AI-gestützter Entwicklung arbeiten
- Entwickler die ihre Workflows optimieren wollen
- Freelancer die ihre Prompt-Bibliothek verwalten möchten
- Agenturen mit mehreren Kundenprojekten

## Changelog

| Version | Datum | Änderungen |
|---------|-------|------------|
| 1.22.3 | 2026-01-23 | SEO-Updates, Multi-Plattform Dokumentation |
| 1.22.2 | 2026-01-23 | @-Mentions in Ticket-Kommentaren |
| 1.21.0 | 2026-01-22 | Multi-Plattform: ChatGPT & Claude Support |
| 1.20.0 | 2026-01-22 | Template-Variablen mit dynamischem Dialog |
| 1.19.0 | 2026-01-21 | Ticket-Kalender: Wochen- und Tagesansicht |
| 1.18.0 | 2026-01-20 | Ticket-Kalender-Ansicht, Drag & Drop |
| 1.17.0 | 2026-01-19 | Ticket-System mit E-Mail-Benachrichtigungen |

## Support und Community

- Lovable.dev Discord Community
- Dokumentation auf der Website
- In-App Hilfe und Tooltips

## Kontakt

Website: https://prompterly.it
Entwickelt für die Lovable.dev Community.