O que é este material
O prompt pronto para colar no Claude, o botão Deploy to Vercel e o passo a passo para instalar o SignuDoc na sua própria conta.
O prompt pronto para colar no Claude, o botão Deploy to Vercel e o passo a passo para instalar o SignuDoc na sua própria conta.
Um app de assinatura de documentos, de código aberto. Roda na sua conta da Vercel, com a sua logo. Você sobe o PDF, marca onde assinar, envia o link, e a pessoa assina pelo celular, sem criar conta. No final, todo mundo recebe o PDF selado e um certificado de auditoria.
O repositório está em github.com/NYLLON-SOFTWARE/SignuDoc.
Abra o Claude, cole o texto abaixo e deixe ele te guiar. Ele pede algumas informações, abre o deploy e te avisa quando você precisa entrar na conta ou criar a senha.
Você vai me ajudar a instalar o SignuDoc na minha conta da Vercel, passo a passo. Siga o guia oficial para agentes: https://github.com/NYLLON-SOFTWARE/SignuDoc/blob/main/docs/deploy-with-an-agent.md Repositório: https://github.com/NYLLON-SOFTWARE/SignuDoc Antes de começar, me pergunte: 1. Se o uso é pessoal ou de clínica/empresa. O plano Hobby da Vercel é só para uso pessoal. Clínica ou empresa precisa do plano Pro. 2. O domínio de onde o e-mail deve sair, por exemplo meudominio.com. O guia sugere um subdomínio sign., como sign.meudominio.com. Se eu ainda não tiver domínio, siga com o padrão do Resend e deixe o e-mail para depois. 3. O nome da organização, como quem assina deve ver. 4. O e-mail de suporte, para quem assina e a equipe pedirem ajuda. 5. Meu nome e e-mail de administrador. A senha eu crio sozinho, ou uso o meu gerenciador de senhas se eu pedir. 6. Se eu quero testar o e-mail antes de verificar o domínio. Se sim, deixe o campo de remetente vazio na configuração. Regras: - Se aparecer tela de login, senha, código ou passkey, pare e peça para eu entrar. - Nunca digite senha, código ou passkey por mim, a menos que eu peça isso. - Nunca pague, faça upgrade ou inicie teste pago sem o meu ok. Se eu recusar o Pro em uso de clínica ou empresa, pare. - Neon, Resend e Vercel Blob: escolha o plano gratuito. Se alguma tela pedir cartão, plano pago ou upgrade, pare e me pergunte. - Nunca apague projeto, banco, repositório ou armazenamento para "começar de novo". Se algo der muito errado, pare e me avise. - Nunca copie segredo, chave, senha ou URL de banco para o chat, arquivo ou mensagem. - Faça um passo de cada vez e confira o resultado na tela antes de seguir. Quando eu responder, abra este endereço (é o botão Deploy to Vercel do README): https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FNYLLON-SOFTWARE%2FSignuDoc&project-name=signudoc&repository-name=signudoc&stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22resend%22%2C%22productSlug%22%3A%22resend-email%22%2C%22protocol%22%3A%22messaging%22%7D%2C%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22neon%22%2C%22productSlug%22%3A%22neon%22%2C%22protocol%22%3A%22storage%22%7D%2C%7B%22type%22%3A%22blob%22%2C%22access%22%3A%22private%22%7D%5D Siga nesta ordem: 1. Peça para a Vercel copiar o SignuDoc para a minha conta do GitHub, com o nome signudoc, a menos que já esteja em uso. Repositório privado pode. Se o GitHub pedir autorização, passkey ou código, passe para mim. 2. Adicione os três serviços no plano gratuito, nesta ordem: Resend (e-mail; use o domínio que eu informar, por exemplo sign.meudominio.com), Neon (banco Postgres, na região mais próxima de mim) e Vercel Blob (arquivos; deixe privado). 3. Clique em Deploy e espere. Costuma levar de 2 a 4 minutos. Se aparecer "One or more integration resources failed to provision", espere 60 a 120 segundos, atualize a página, confira em Storage se Resend, Neon e Blob estão listados, abra Deployments, no menu (⋯) do deploy que falhou clique em Redeploy. Se falhar do mesmo jeito, espere 3 a 5 minutos e tente de novo. Depois de 3 tentativas, pare e me diga a mensagem e o horário. Se o build falhar com log, não fique tentando de novo: copie as últimas 30 linhas do log e me entregue. 4. Abra o site de produção na hora. Quem abre primeiro fica dono da instalação. Se abrir em /setup, siga. Se pedir para conectar um banco, em Storage conecte o Neon à Production, faça Redeploy e recarregue o site. 5. Na página de setup, preencha o nome da organização e o e-mail de suporte. Confira o campo Send email from. Se eu quiser testar o e-mail antes de verificar o domínio, deixe esse campo vazio. Peça para eu digitar a senha. Não invente senha e não a guarde. 6. Em Settings, Organization, confira o e-mail. Se aparecer "Email is not connected", faça um Redeploy e recarregue. Se listar registros DNS ainda não verificados, me entregue a lista para eu adicionar onde o domínio é gerenciado. Isso pode levar de minutos a algumas horas. No fim, me diga: o endereço do site, o repositório no GitHub, se o e-mail já está verificado, quais registros DNS ainda faltam e o que você não conseguiu fazer. Pode começar pelas perguntas.
Com Node.js 24 e Docker:
npm install cp .env.example .env npm run db:start # Postgres in Docker, with the schema applied npm run dev # SignuDoc at http://localhost:3000
O app abre em http://localhost:3000. Os arquivos ficam no disco e os e-mails vão para `.data/outbox`, sem precisar de conta externa.
O botão Deploy to Vercel não pede nenhuma variável: a Vercel liga o banco, o armazenamento e o e-mail sozinha. No computador, estas três são as que o desenvolvimento local precisa:
DATABASE_URL=postgres://signudoc:signudoc@127.0.0.1:5432/signudoc APP_URL=http://localhost:3000 EMAIL_DRIVER=capture
Para testar na hora, deixe "Send email from" vazio e envie o primeiro documento para o e-mail da sua conta Resend.
O SignuDoc em si é gratuito. O botão de deploy usa os planos gratuitos da Vercel, do Neon e do Resend, que suportam cerca de 250 documentos por mês. O plano Hobby da Vercel é só para uso pessoal. Clínica ou empresa usa o plano Pro, que na documentação do projeto custa US$ 20 por mês para quem faz o deploy.
Limites dos planos gratuitos, segundo o repositório:
| Serviço | Limite |
|---|---|
| Vercel Blob | 2.000 uploads por mês, cerca de 250 documentos |
| Resend | 3.000 e-mails por mês e no máximo 100 por dia |
| Neon | 1 GB e 100 horas de computação |
Passar do limite não gera cobrança. O serviço para até o mês virar ou, no caso do armazenamento, até você apagar documentos antigos.
Exemplos de documentos para mandar assinar: