Communitygithub.com

Suite de Protocolo VibeCode - Resend Compartido para Portafolio

Reutiliza una cuenta de Resend y un dominio verificado de remitente en múltiples productos con marca propia, ideal para desarrolladores independientes y portafolios en el nivel gratuito. Úsalo al agregar correo transaccional a otra app sin crear una cuenta o dominio verificado separado, preservando la identidad por producto, destinatarios, enrutamiento de Reply-To, plantillas, límites de seguridad, confiabilidad de entrega y conocimiento de una cuota compartida.

¿Qué es Suite de Protocolo VibeCode - Resend Compartido para Portafolio?

Esta habilidad de protocolo permite a un desarrollador independiente o un pequeño portafolio de apps reutilizar una única cuenta de Resend y un dominio verificado de remitente para enviar correos transaccionales desde múltiples productos. En lugar de crear cuentas y dominios separados para cada app (lo cual aumenta costos y complejidad), la habilidad proporciona un modelo compartido de infraestructura de envío. Cada aplicación conserva su propia identidad de remitente (nombre visible), bandeja de entrada de destino, enrutamiento de Reply-To, plantillas HTML con marca visual distinta y variables de entorno. Todas las apps comparten la misma cuota de nivel gratuito y la reputación del dominio verificado, por lo que incluye salvaguardas como límites anti-spam, control de errores y verificación de entrega. Está diseñada para plataformas como Claude Code, Cursor y Codex, y se basa en el paquete oficial `resend`, módulos solo del lado del servidor, y configuraciones por producto a través de variables de entorno. La implementación prioriza la separación de mensajes internos y de confirmación, la gestión segura de claves API y la confiabilidad de entrega sin exponer secretos.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Resend Compartido para Portafolio

Implementa correo electrónico para múltiples productos mediante una sola cuenta de Resend y un dominio verificado. Optimizado para un desarrollador independiente o un portafolio pequeño que usa el nivel gratuito, sin que cada app parezca el mismo producto.

Modelo central

Comparte infraestructura, no la identidad del producto:

Una cuenta de Resend
└── Dominio de remitente verificado existente
    ├── Identidad de remitente del Producto A
    ├── Identidad de remitente del Producto B
    └── Identidad de remitente del Producto C

Cada app conserva lo suyo:

  • nombre visible del remitente
  • bandeja de entrada de destino
  • enrutamiento de Reply-To
  • convenciones de asunto
  • plantillas HTML con marca visual y texto plano
  • variables de entorno de despliegue
  • registros de entrega y comportamiento ante fallos

Todas las apps comparten la cuota de nivel gratuito de la cuenta y la reputación del dominio verificado.

Descubrimiento del portafolio

Antes de la implementación:

  1. Inspecciona la app de destino y cualquier app hermana que ya tenga una configuración de Resend funcionando.
  2. Identifica la cuenta de Resend canónica y el dominio ya verificado.
  3. Confirma el nombre visible del producto, la bandeja de entrada compartida del remitente, el destinatario interno, la bandeja de entrada de soporte para Reply-To y los tipos de correo esperados.
  4. Confirma si el despliegue de destino ya tiene una clave API de Resend.
  5. No le pidas al usuario que cree otra cuenta, verifique otro dominio o compre un plan a menos que la cuenta existente no pueda cumplir con un requisito explícito.

Estrategia de cuenta y clave

Reutiliza la misma cuenta de Resend y dominio verificado. Prefiere una clave API separada por app desplegada cuando la cuenta lo permita; esto limita el impacto de una clave filtrada o rotada, manteniéndose en una sola cuenta y cuota. Reutiliza la misma clave solo cuando no haya claves separadas disponibles o el usuario prefiera explícitamente ese compromiso.

Nunca copies secretos de otro repositorio al control de código fuente. Agrega la clave seleccionada directamente al entorno secreto de cada despliegue.

Configuración por producto

Usa variables solo del lado del servidor y nombres específicos del producto cuando sea práctico. Resuelve sus valores a partir de la cuenta de Resend existente del usuario, la configuración de remitente verificado y la bandeja de entrada prevista del producto; nunca copies identidades de ejemplo en una implementación.

Rol de la variablePropósito
Clave API de ResendAutentica la llamada al proveedor desde el servidor
Identidad de remitente del productoCombina el nombre visible del producto actual con una dirección en el dominio verificado existente
Destinatario de contacto del productoRecibe las notificaciones internas de este producto
Dirección de respuesta del productoRecibe las respuestas a los mensajes dirigidos al usuario cuando es diferente del destinatario de contacto

El nombre visible proporciona la identidad del producto; la dirección verificada existente proporciona la capacidad de entrega. Nunca uses una variable NEXT_PUBLIC_ o equivalente expuesta al cliente para una clave API.

Enrutamiento del formulario de contacto

Envía dos mensajes separados:

Notificación interna
De: identidad de remitente configurada del producto
Para: bandeja de entrada interna configurada del producto
Reply-To: dirección validada enviada por el visitante

Confirmación al visitante
De: identidad de remitente configurada del producto
Para: dirección validada enviada por el visitante
Reply-To: bandeja de entrada interna configurada del producto

No pongas al visitante y a la bandeja de entrada interna en una misma lista de destinatarios. Los mensajes separados evitan la exposición de direcciones y permiten contenido diferente.

Trata la notificación interna como entrega principal. Devuelve éxito del formulario solo después de que Resend la acepte y devuelva un ID de mensaje. Intenta la confirmación al visitante después; registra su fallo sin afirmar que la consulta principal se perdió.

Aislamiento de marca

Crea una plantilla distinta para cada producto manteniendo el patrón del módulo de proveedor reutilizable. Personaliza:

  • nombre y descriptor del producto
  • colores, tipografía y tratamiento del encabezado
  • texto de vista previa del correo
  • asuntos y tono
  • pie de página, dirección de soporte y expectativas de respuesta

Usa diseños de tabla, CSS en línea, un ancho de contenido de 600–640px, valores de usuario escapados y una versión de texto plano. No reutilices la identidad visual de otro producto solo porque la infraestructura de envío es compartida.

Salvaguardas del nivel gratuito compartido

  • Revisa los límites actuales del nivel gratuito de Resend en lugar de confiar en números recordados.
  • Recuerda que cada app consume la misma cuota de la cuenta.
  • Envía solo mensajes transaccionales necesarios; evita notificaciones duplicadas.
  • Mantén controles anti-spam en formularios públicos: validación, límites de longitud, honeypot y limitación de velocidad cuando corresponda.
  • Evita bucles de reintento que puedan enviar duplicados. Persiste o usa idempotencia donde el flujo de trabajo tenga un riesgo significativo de reintento.
  • Monitorea rechazos del proveedor y errores de cuota sin registrar secretos ni datos personales innecesarios.
  • Escala a otra cuenta o plan de pago solo cuando el volumen medido, el aislamiento, el cumplimiento normativo o los requisitos de reputación lo justifiquen.

Implementación confiable

  1. Instala el paquete oficial resend en el espacio de trabajo correcto.
  2. Mantén las llamadas al proveedor en un módulo solo del lado del servidor.
  3. Valida result.data?.id y asegúrate de que result.error esté ausente.
  4. Captura excepciones del SDK y de red.
  5. Establece replyTo explícitamente.
  6. Devuelve 503 cuando el correo no esté configurado y 502 cuando la entrega principal falle.
  7. Preserva alternativas de contacto directo por correo, teléfono o mensajería en la interfaz de usuario.
  8. Nunca reportes un manejo solo de registro como una entrega exitosa.

Verificación

  • Confirma que el dominio compartido esté verificado en la cuenta de Resend reutilizada.
  • Confirma los valores específicos del producto para From, To y Reply-To.
  • Prueba la entrega interna, luego la confirmación al visitante, luego responder en ambas direcciones.
  • Prueba la validación, el honeypot, la clave faltante, el rechazo del proveedor y las rutas alternativas.
  • Ejecuta los comandos de verificación de tipos, lint, prueba y compilación nativos del repositorio.
  • Confirma que el despliegue contenga su clave API y variables del producto.
  • Realiza un envío real antes de afirmar que la entrega en vivo funciona.

Individual skills in this repo

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

Skills relacionados