Communitygithub.com

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

Reutilize uma conta Resend e um domínio de remetente verificado em vários produtos, ideal para desenvolvedores solo e portfólios com plano gratuito. Use ao adicionar e-mail transacional a outro aplicativo sem criar uma conta Resend separada ou domínio verificado, preservando identidade por produto, destinatários, roteamento de Reply-To, modelos, limites de segurança, confiabilidade de entrega e ciência de uma cota de envio compartilhada.

O que é VibeCode-Protocol-Suite?

Este protocolo permite que um desenvolvedor solo ou portfólio utilize uma única conta Resend e um domínio verificado para enviar e-mails de múltiplos produtos, otimizando o uso do plano gratuito sem que cada aplicativo pareça ser do mesmo produto. Ele foca em reutilizar a infraestrutura de envio sem comprometer a identidade visual, a segurança e a confiabilidade de cada aplicativo. O protocolo orienta sobre estratégias de chave da API, configuração por produto (remetente, destinatário interno, roteamento de Reply-To), isolamento de marca com templates personalizados e roteamento seguro de formulários de contato. Também inclui práticas recomendadas para lidar com cotas compartilhadas, evitar duplicatas e garantir uma implementação confiável com tratamento de erros e testes.

Funciona com~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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Portfólio Resend Compartilhado

Implemente e-mail para múltiplos produtos através de uma única conta Resend e domínio verificado. Otimizado para desenvolvedores solo ou portfólios pequenos que utilizam o plano gratuito sem fazer com que cada aplicativo pareça o mesmo produto.

Modelo principal

Compartilhe infraestrutura, não identidade do produto:

Uma conta Resend
└── Domínio de remetente verificado existente
    ├── Identidade do remetente do Produto A
    ├── Identidade do remetente do Produto B
    └── Identidade do remetente do Produto C

Cada aplicativo mantém seus próprios:

  • nome de exibição do remetente
  • caixa de entrada de destino
  • roteamento de Reply-To
  • convenções de assunto
  • templates HTML e texto simples com marca própria
  • variáveis de ambiente de implantação
  • logs de entrega e comportamento de falha

Todos os aplicativos compartilham a cota do plano gratuito e a reputação do domínio verificado ao nível da conta.

Descoberta do portfólio

Antes da implementação:

  1. Inspecione o aplicativo alvo e qualquer aplicativo irmão com uma configuração Resend funcional.
  2. Identifique a conta Resend canônica e o domínio já verificado.
  3. Confirme o nome de exibição do produto, caixa de correio do remetente compartilhada, destinatário interno, caixa de entrada de suporte Reply-To e tipos de e-mail esperados.
  4. Confirme se a implantação alvo já possui uma chave da API Resend.
  5. Não peça ao usuário para criar outra conta, verificar outro domínio ou comprar um plano, a menos que a conta existente não possa atender a um requisito declarado.

Estratégia de conta e chave

Reutilize a mesma conta Resend e domínio verificado. Prefira uma chave da API separada por aplicativo implantado, quando a conta permitir; isso limita o impacto de uma chave vazada ou rotacionada, permanecendo em uma única conta e cota. Reutilize a mesma chave apenas quando chaves separadas não estiverem disponíveis ou o usuário preferir explicitamente essa compensação.

Nunca copie segredos de outro repositório para o controle de versão. Adicione a chave selecionada diretamente ao ambiente de segredos de cada implantação.

Configuração por produto

Use variáveis exclusivas do servidor e nomes específicos do produto sempre que possível. Resolva seus valores a partir da conta Resend existente do usuário, da configuração de remetente verificada e da caixa de entrada pretendida do produto — nunca copie identidades de exemplo em uma implementação.

Função da variávelPropósito
Chave da API ResendAutentica a chamada do provedor no lado do servidor
Identidade do remetente do produtoCombina o nome de exibição do produto atual com um endereço no domínio verificado existente
Destinatário de contato do produtoRecebe as notificações internas deste produto
Endereço de resposta do produtoRecebe respostas para mensagens voltadas ao usuário, quando diferente do destinatário de contato

O nome de exibição visível fornece a identidade do produto; o endereço verificado existente fornece entregabilidade. Nunca use uma variável NEXT_PUBLIC_ ou equivalente exposta ao cliente para uma chave da API.

Roteamento de formulário de contato

Envie duas mensagens separadas:

Notificação interna
De: identidade do remetente do produto configurada
Para: caixa de entrada interna do produto configurada
Reply-To: endereço validado enviado pelo visitante

Confirmação para o visitante
De: identidade do remetente do produto configurada
Para: endereço validado enviado pelo visitante
Reply-To: caixa de entrada interna do produto configurada

Não coloque o visitante e a caixa de entrada interna em uma única lista de destinatários. Mensagens separadas evitam exposição de endereços e permitem conteúdo diferente.

Trate a notificação interna como entrega primária. Retorne sucesso do formulário apenas após o Resend aceitá-la e retornar um ID de mensagem. Tente a confirmação do visitante em seguida; registre sua falha sem afirmar que a consulta primária foi perdida.

Isolamento de marca

Crie um shell de template distinto para cada produto, mantendo o padrão do módulo do provedor reutilizável. Personalize:

  • nome e descritor do produto
  • cores, tipografia e tratamento do cabeçalho
  • texto de pré-visualização do e-mail
  • assuntos e tom
  • rodapé de propriedade, endereço de suporte e expectativas de resposta

Use layouts de tabela, CSS inline, largura de conteúdo de 600–640px, valores de usuário escapados e uma versão em texto simples. Não reutilize a identidade visual de outro produto apenas porque a infraestrutura de remetente é compartilhada.

Salvaguardas de plano gratuito compartilhado

  • Verifique os limites atuais do plano gratuito do Resend em vez de confiar em números memorizados.
  • Lembre-se de que cada aplicativo consome a mesma cota da conta.
  • Envie apenas mensagens transacionais necessárias; evite notificações duplicadas.
  • Mantenha controles anti-spam em formulários públicos: validação, limites de comprimento, honeypot e limitação de taxa quando apropriado.
  • Evite loops de repetição que possam enviar duplicatas. Persista ou use idempotência onde o fluxo de trabalho tem risco significativo de repetição.
  • Monitore rejeições do provedor e erros de cota sem registrar segredos ou dados pessoais desnecessários.
  • Escalone para outra conta ou plano pago apenas quando volume medido, isolamento, conformidade ou requisitos de reputação justificarem.

Implementação confiável

  1. Instale o pacote oficial resend no workspace correto.
  2. Mantenha chamadas ao provedor em um módulo exclusivo do servidor.
  3. Valide result.data?.id e garanta que result.error esteja ausente.
  4. Capture exceções do SDK e de rede.
  5. Defina replyTo explicitamente.
  6. Retorne 503 quando o e-mail não estiver configurado e 502 quando a entrega primária falhar.
  7. Preserve alternativas de contato direto (e-mail, telefone ou mensagens) na interface do usuário.
  8. Nunca relate tratamento apenas em log como entrega bem-sucedida.

Verificação

  • Confirme que o domínio compartilhado está verificado na conta Resend reutilizada.
  • Confirme os valores de From, To e Reply-To específicos do produto.
  • Teste a entrega interna, depois a confirmação do visitante e depois responda em ambas as direções.
  • Teste validação, honeypot, chave ausente, rejeição do provedor e caminhos de fallback.
  • Execute comandos nativos do repositório de typecheck, lint, teste e build.
  • Confirme que a implantação contém sua chave da API e variáveis do produto.
  • Realize uma submissão real antes de afirmar que a entrega ao vivo funciona.

Individual skills in this repo

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

Habilidades Relacionadas