Communitygithub.com

J-StaR-Films-Studios/VibeCode-Protocol-Suite

Ein einzelnes Resend-Konto und eine bestätigte Absenderdomäne für mehrere Produkte wiederverwenden, speziell für Solo-Entwickler und Portfolios im Free-Tarif. Verwende dies, um transaktionale E-Mails zu einer anderen App hinzuzufügen, ohne ein separates Resend-Konto oder eine bestätigte Domäne zu erstellen, während die Identität, Empfänger, Reply-To-Weiterleitung, Vorlagen, Sicherheitsgrenzen, Zustellzuverlässigkeit und das Bewusstsein für ein gemeinsames Sendekontingent pro Produkt erhalten bleiben.

Was ist VibeCode-Protocol-Suite?

Diese Fähigkeit (Skill) ermöglicht es Entwicklern, ein einziges Resend-Konto mit einer bestätigten Absenderdomäne für mehrere Produkte oder Apps wiederzuverwenden. Sie wurde speziell für Solo-Entwickler und kleine Portfolios optimiert, die den kostenlosen Resend-Tarif nutzen. Anstatt für jede App ein separates Konto oder eine separate Domäne zu erstellen, teilt man die Zustellinfrastruktur, behält aber die individuelle Identität jedes Produkts bei – inklusive eigenem Absendernamen, Zielpostfach, Reply-To-Weiterleitung und gebrandeten HTML-/Textvorlagen. Der Skill behandelt die gesamte Konfiguration von API-Keys, Produktvariablen, Kontaktformular-Routing und Vorlagenisolation. Er enthält klare Richtlinien zur gemeinsamen Nutzung des Free-Tarif-Kontingents, zur Vermeidung doppelter Benachrichtigungen und zur Implementierung von Anti-Spam-Maßnahmen. Zudem wird ein zuverlässiger Implementierungsablauf mit Fehlerbehandlung und Rückfallmechanismen (Fallbacks) beschrieben. Die Fähigkeit ist plattformunabhängig und kann mit jedem Resend-kompatiblen Setup verwendet werden, einschließlich Frameworks wie Next.js, Remix oder Node.js-basierten Backends. Sie folgt dem Prinzip, Code und Konfiguration nicht zu duplizieren, sondern durch klare Variablen und Umgebungsvariablen zu trennen. Der Skill endet mit einer detaillierten Checkliste zur Verifizierung, die sicherstellt, dass alle Konfigurationen korrekt sind, Tests durchgeführt wurden und die Live-Zustellung funktioniert, bevor die Implementierung als abgeschlossen gemeldet wird.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/J-StaR-Films-Studios/VibeCode-Protocol-Suite/tree/HEAD/assets/.agent/skills/web-dev-standards/shared-resend-portfolio

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Gemeinsames Resend-Portfolio

Implementiere E-Mails für mehrere Produkte mit einem einzigen Resend-Konto und einer bestätigten Domäne. Optimiere für Solo-Entwickler oder kleine Portfolios, die den Free-Tarif nutzen, ohne dass jede App wie dasselbe Produkt aussieht.

Kernmodell

Teile die Infrastruktur, nicht die Produktidentität:

Ein Resend-Konto
└── Bestätigte Absenderdomäne
    ├── Produkt-A Absenderidentität
    ├── Produkt-B Absenderidentität
    └── Produkt-C Absenderidentität

Jede App behält ihre eigenen:

  • Anzeigenamen des Absenders
  • Zielpostfach
  • Reply-To-Weiterleitung
  • Betreffkonventionen
  • Gebrandete HTML- und Klartextvorlagen
  • Umgebungsvariablen für die Bereitstellung
  • Zustell-Logs und Fehlerverhalten

Alle Apps teilen sich das Kontingent des Free-Tarifs auf Kontenebene und den Ruf der bestätigten Domäne.

Portfolio-Erkundung

Vor der Implementierung:

  1. Untersuche die Ziel-App und jede Schwester-App mit einem funktionierenden Resend-Setup.
  2. Identifiziere das kanonische Resend-Konto und die bereits bestätigte Domäne.
  3. Bestätige den Produkt-Anzeigenamen, das gemeinsame Absenderpostfach, den internen Empfänger, das Support-Reply-To-Postfach und die erwarteten E-Mail-Typen.
  4. Bestätige, ob die Zielbereitstellung bereits einen Resend-API-Key hat.
  5. Bitte den Benutzer nicht, ein weiteres Konto zu erstellen, eine weitere Domäne zu bestätigen oder einen Tarif zu kaufen, es sei denn, das bestehende Konto kann eine angegebene Anforderung nicht erfüllen.

Konto- und Schlüsselstrategie

Verwende dasselbe Resend-Konto und dieselbe bestätigte Domäne wieder. Bevorzuge einen separaten API-Key pro bereitgestellter App, wenn das Konto dies zulässt; dies begrenzt die Auswirkungen eines geleakten oder rotierten Schlüssels, während man bei einem Konto und Kontingent bleibt. Verwende denselben Schlüssel nur dann wieder, wenn separate Schlüssel nicht verfügbar sind oder der Benutzer diesen Kompromiss explizit bevorzugt.

Kopiere niemals Geheimnisse aus einem anderen Repository in die Quellcodeverwaltung. Füge den ausgewählten Schlüssel direkt in die geheimen Umgebungsvariablen jeder Bereitstellung ein.

Produktspezifische Konfiguration

Verwende server-seitige Variablen und produktspezifische Namen, wo praktikabel. Löse deren Werte aus dem bestehenden Resend-Konto des Benutzers, der bestätigten Absenderkonfiguration und dem beabsichtigten Produktpostfach auf – kopiere niemals Beispielidentitäten in eine Implementierung.

VariablenrolleZweck
Resend-API-KeyAuthentifiziert den serverseitigen Provider-Aufruf
Produkt-AbsenderidentitätKombiniert den Anzeigenamen des aktuellen Produkts mit einer Adresse auf der bestehenden bestätigten Domäne
Produkt-KontaktempfängerEmpfängt die internen Benachrichtigungen dieses Produkts
Produkt-AntwortadresseEmpfängt Antworten auf benutzerseitige Nachrichten, wenn sie sich vom Kontaktempfänger unterscheidet

Der sichtbare Anzeigename liefert die Produktidentität; die bestehende bestätigte Adresse liefert die Zustellbarkeit. Verwende niemals eine NEXT_PUBLIC_ oder eine äquivalente clientseitig exponierte Variable für einen API-Key.

Kontaktformular-Routing

Sende zwei separate Nachrichten:

Interne Benachrichtigung
Von: konfigurierte Produkt-Absenderidentität
An: konfiguriertes internes Produktpostfach
Reply-To: validierte, vom Besucher eingegebene Adresse

Bestätigung für den Besucher
Von: konfigurierte Produkt-Absenderidentität
An: validierte, vom Besucher eingegebene Adresse
Reply-To: konfiguriertes internes Produktpostfach

Setze den Besucher und das interne Postfach nicht in eine einzige Empfängerliste. Getrennte Nachrichten verhindern die Offenlegung von Adressen und ermöglichen unterschiedliche Inhalte.

Behandle die interne Benachrichtigung als primäre Zustellung. Gib den Formularerfolg erst zurück, nachdem Resend sie akzeptiert und eine Nachrichten-ID zurückgegeben hat. Versuche danach die Bestätigung für den Besucher; protokolliere ihren Fehler, ohne zu behaupten, dass die primäre Anfrage verloren gegangen sei.

Markenisolation

Erstelle für jedes Produkt eine eigene Vorlagenhülle, während das Provider-Modul-Muster wiederverwendbar bleibt. Passe Folgendes an:

  • Produktname und Beschreibung
  • Farben, Typografie und Kopfzeilenbehandlung
  • E-Mail-Vorschautext
  • Betreff und Ton
  • Fußzeilen-Impressum, Support-Adresse und Reaktionserwartungen

Verwende Tabellenlayouts, Inline-CSS, eine Inhaltsbreite von 600–640 Pixeln, maskierte Benutzerwerte und eine Klartextversion. Verwende nicht die visuelle Identität eines anderen Produkts, nur weil die Sendeinfrastruktur gemeinsam genutzt wird.

Sicherheitsvorkehrungen für den gemeinsamen Free-Tarif

  • Überprüfe die aktuellen Resend-Free-Tarif-Grenzen, anstatt dich auf gespeicherte Zahlen zu verlassen.
  • Bedenke, dass jede App das gleiche Kontingent verbraucht.
  • Sende nur notwendige transaktionale Nachrichten; vermeide doppelte Benachrichtigungen.
  • Behalte Anti-Spam-Kontrollen auf öffentlichen Formularen bei: Validierung, Längenbeschränkungen, Honeypot sowie gegebenenfalls Ratenbegrenzung.
  • Vermeide Wiederholungsschleifen, die Duplikate senden können. Verwende Persistenz oder Idempotenz, wo der Workflow ein sinnvolles Wiederholungsrisiko aufweist.
  • Überwache Provider-Ablehnungen und Kontingentfehler, ohne Geheimnisse oder unnötige persönliche Daten zu protokollieren.
  • Wechsle zu einem anderen Konto oder einem kostenpflichtigen Tarif nur, wenn der gemessene Bedarf, die Isolierung, die Compliance oder die Rufanforderungen dies rechtfertigen.

Zuverlässige Implementierung

  1. Installiere das offizielle resend-Paket im richtigen Workspace.
  2. Halte Provider-Aufrufe in einem server-seitigen Modul.
  3. Validiere result.data?.id und stelle sicher, dass result.error nicht vorhanden ist.
  4. Fange SDK- und Netzwerkausnahmen ab.
  5. Setze replyTo explizit.
  6. Gib 503 zurück, wenn E-Mail nicht konfiguriert ist, und 502, wenn die primäre Zustellung fehlschlägt.
  7. Halte direkte E-Mail-, Telefon- oder Messaging-Fallbacks in der UI bereit.
  8. Melde eine reine Log-Behandlung niemals als erfolgreiche Zustellung.

Verifizierung

  • Bestätige, dass die gemeinsame Domäne im wiederverwendeten Resend-Konto bestätigt ist.
  • Bestätige die produktspezifischen Von-, An- und Reply-To-Werte.
  • Teste die interne Zustellung, dann die Besucherbestätigung, dann das Antworten in beide Richtungen.
  • Teste Validierung, Honeypot, fehlenden Key, Provider-Ablehnung und Fallback-Pfade.
  • Führe repository-eigene Typüberprüfungs-, Lint-, Test- und Build-Befehle aus.
  • Bestätige, dass die Bereitstellung ihren API-Key und die Produktvariablen enthält.
  • Führe eine echte Übermittlung durch, bevor du behauptest, dass die Live-Zustellung funktioniert.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills