Communitygithub.com

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

Réutiliser un seul compte Resend et un domaine d'expéditeur vérifié sur plusieurs produits de marque, particulièrement pour les développeurs solo et les portfolios gratuits. À utiliser lors de l'ajout d'e-mails transactionnels à une autre application sans créer un compte Resend ou un domaine vérifié séparé, tout en préservant l'identité par produit, les destinataires, le routage Répondre-À, les modèles, les limites de sécurité, la fiabilité de livraison et la connaissance d'un quota d'envoi partagé.

Qu'est-ce que VibeCode-Protocol-Suite ?

Ce skill permet aux développeurs solo ou ayant un petit portfolio d'implémenter des fonctionnalités e-mail transactionnelles pour plusieurs applications de marque en utilisant un seul compte Resend (souvent gratuit) et un seul domaine d'expéditeur vérifié. Il évite la duplication des comptes et des processus de vérification tout en maintenant une identité distincte pour chaque produit via des noms d'affichage, des destinataires, des routages Répondre-À, des templates et des jeux de variables d'environnement personnalisés. Le skill garantit que chaque application utilise ses propres clés API pour limiter l'impact des fuites et partage le quota du niveau gratuit, avec des mécanismes de sécurité tels que des messages séparés pour les notifications internes et les confirmations des visiteurs, des protections anti-spam et des contrôles de fiabilité comme l'idempotence. Il s'applique aussi bien à des agents codant (par exemple, Claude Code, Cursor) qu'à des déploiements de développeurs, en générant la configuration exacte de l'e-mail en fonction de l'infrastructure Resend existante du projet.

Compatible avec~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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Portfolio Resend Partagé

Implémentez l'e-mail pour plusieurs produits via un seul compte Resend et un domaine vérifié. Optimisé pour un développeur solo ou un petit portfolio utilisant le niveau gratuit, sans que chaque application ne ressemble au même produit.

Modèle de base

Partagez l'infrastructure, pas l'identité du produit :

Un compte Resend
└── Domaine d'expéditeur vérifié existant
    ├── Identité d'expéditeur du produit A
    ├── Identité d'expéditeur du produit B
    └── Identité d'expéditeur du produit C

Chaque application conserve ses propres :

  • nom d'affichage de l'expéditeur
  • boîte de réception de destination
  • routage Répondre-À
  • conventions de sujet
  • templates HTML et texte brut de marque
  • variables d'environnement de déploiement
  • journaux de livraison et comportement en cas d'échec

Toutes les applications partagent le quota du niveau gratuit du compte et la réputation du domaine vérifié.

Découverte du portfolio

Avant l'implémentation :

  1. Inspectez l'application cible et toute application sœur avec une configuration Resend fonctionnelle.
  2. Identifiez le compte Resend canonique et le domaine déjà vérifié.
  3. Confirmez le nom d'affichage du produit, la boîte aux lettres partagée de l'expéditeur, le destinataire interne, la boîte de réception Répondre-À du support et les types d'e-mails attendus.
  4. Confirmez si le déploiement cible possède déjà une clé API Resend.
  5. Ne demandez pas à l'utilisateur de créer un autre compte, de vérifier un autre domaine ou d'acheter un forfait, sauf si le compte existant ne peut pas répondre à une exigence déclarée.

Stratégie de compte et de clé

Réutilisez le même compte Resend et le même domaine vérifié. Préférez une clé API distincte par application déployée lorsque le compte le permet ; cela limite l'impact d'une fuite ou d'une rotation de clé tout en restant sur un seul compte et quota. Réutilisez la même clé uniquement lorsque des clés distinctes ne sont pas disponibles ou que l'utilisateur préfère explicitement ce compromis.

Ne copiez jamais les secrets d'un autre dépôt dans le contrôle de source. Ajoutez la clé sélectionnée directement dans l'environnement secret de chaque déploiement.

Configuration par produit

Utilisez des variables côté serveur et des noms spécifiques au produit lorsque cela est pratique. Résolvez leurs valeurs à partir du compte Resend existant de l'utilisateur, de la configuration d'expéditeur vérifié et de la boîte de réception prévue du produit – ne copiez jamais d'identités d'exemple dans une implémentation.

Rôle de la variableObjectif
Clé API ResendAuthentifie l'appel du fournisseur côté serveur
Identité d'expéditeur du produitCombine le nom d'affichage du produit actuel avec une adresse sur le domaine vérifié existant
Destinataire de contact du produitReçoit les notifications internes de ce produit
Adresse de réponse du produitReçoit les réponses aux messages destinés aux utilisateurs lorsqu'elle est différente du destinataire de contact

Le nom d'affichage visible fournit l'identité du produit ; l'adresse vérifiée existante fournit la délivrabilité. N'utilisez jamais une variable exposée côté client comme NEXT_PUBLIC_ ou équivalent pour une clé API.

Routage du formulaire de contact

Envoyez deux messages séparés :

Notification interne
De : identité d'expéditeur du produit configurée
À : boîte de réception interne du produit configurée
Répondre-À : adresse validée soumise par le visiteur

Confirmation au visiteur
De : identité d'expéditeur du produit configurée
À : adresse validée soumise par le visiteur
Répondre-À : boîte de réception interne du produit configurée

Ne placez pas le visiteur et la boîte de réception interne dans une seule liste de destinataires. Des messages séparés évitent l'exposition des adresses et permettent un contenu différent.

Traitez la notification interne comme une livraison principale. Renvoyez le succès du formulaire uniquement après que Resend l'ait accepté et renvoie un ID de message. Tentez ensuite la confirmation au visiteur ; enregistrez son échec sans prétendre que la demande principale a été perdue.

Isolation de marque

Créez une coque de modèle distincte pour chaque produit tout en conservant un motif de module fournisseur réutilisable. Personnalisez :

  • nom et descripteur du produit
  • couleurs, typographie et traitement de l'en-tête
  • texte d'aperçu de l'e-mail
  • sujets et ton
  • propriété du pied de page, adresse de support et attentes de réponse

Utilisez des dispositions de tableau, du CSS en ligne, une largeur de contenu de 600 à 640 pixels, des valeurs utilisateur échappées et une version texte brut. Ne réutilisez pas l'identité visuelle d'un autre produit simplement parce que l'infrastructure d'expéditeur est partagée.

Garanties du niveau gratuit partagé

  • Vérifiez les limites actuelles du niveau gratuit de Resend plutôt que de vous fier à des nombres mémorisés.
  • Rappelez-vous que chaque application consomme le même quota de compte.
  • Envoyez uniquement les messages transactionnels nécessaires ; évitez les notifications en double.
  • Maintenez des contrôles anti-spam sur les formulaires publics : validation, limites de longueur, piège à robots, et limitation de débit le cas échéant.
  • Évitez les boucles de nouvelles tentatives susceptibles d'envoyer des doublons. Persistez ou utilisez l'idempotence lorsque le flux de travail présente un risque significatif de nouvelle tentative.
  • Surveillez les rejets du fournisseur et les erreurs de quota sans enregistrer de secrets ni de données personnelles inutiles.
  • Passez à un autre compte ou un forfait payant uniquement lorsque le volume mesuré, l'isolation, la conformité ou les exigences de réputation le justifient.

Implémentation fiable

  1. Installez le package officiel resend dans l'espace de travail correct.
  2. Conservez les appels au fournisseur dans un module côté serveur uniquement.
  3. Validez result.data?.id et assurez-vous que result.error est absent.
  4. Attrapez les exceptions du SDK et du réseau.
  5. Définissez replyTo explicitement.
  6. Renvoyez 503 lorsque l'e-mail n'est pas configuré et 502 lorsque la livraison principale échoue.
  7. Préservez les solutions de repli par e-mail direct, téléphone ou messagerie dans l'interface utilisateur.
  8. Ne signalez jamais un traitement uniquement enregistré comme une livraison réussie.

Vérification

  • Confirmez que le domaine partagé est vérifié dans le compte Resend réutilisé.
  • Confirmez les valeurs De, À et Répondre-À spécifiques au produit.
  • Testez la livraison interne, puis la confirmation au visiteur, puis la réponse dans les deux sens.
  • Testez la validation, le piège à robots, la clé manquante, le rejet du fournisseur et les chemins de repli.
  • Exécutez les commandes natives du dépôt : vérification de type, lint, test et construction.
  • Confirmez que le déploiement contient sa clé API et ses variables de produit.
  • Effectuez une soumission réelle avant de prétendre que la livraison en direct fonctionne.

Individual skills in this repo

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

Skills associés