better-auth-best-practices

Visão Geral

O que é better-auth-best-practices?

better-auth-best-practices é um guia prático e skill de configuração para integrar o Better Auth ao seu backend em TypeScript. Abrange passos essenciais para configurar servidores e clientes de autenticação, ajustar adaptadores de banco de dados, gerenciar sessões, adicionar plugins e manipular variáveis de ambiente. Esta skill é destinada a desenvolvedores backend que precisam de fluxos de autenticação robustos, incluindo email/senha, OAuth e configurações baseadas em plugins.

Para quem é esta skill?

• Desenvolvedores backend que trabalham com TypeScript
• Equipes implementando autenticação em projetos Node.js
• Projetos que exigem autenticação segura e flexível com Better Auth
• Quem precisa gerenciar configuração de autenticação, variáveis de ambiente e adaptadores de banco de dados

Problemas que resolve

• Simplifica a configuração do Better Auth em projetos novos ou existentes
• Fornece orientações claras sobre variáveis de ambiente e localização de arquivos
• Facilita o gerenciamento de adaptadores de banco de dados e sessões
• Oferece referências rápidas para comandos CLI e integração de plugins

Como Usar

Passos para Instalação

1. Instale o Better Auth no seu projeto:

   npm install better-auth
   

2. Defina as variáveis de ambiente necessárias:
   • BETTER_AUTH_SECRET (mínimo 32 caracteres; gere com openssl rand -base64 32)
   • BETTER_AUTH_URL (sua URL base, ex: https://example.com)
3. Crie um arquivo auth.ts na raiz do projeto, ou nas pastas lib, utils ou src. Este arquivo deve configurar seu adaptador de banco de dados e opções de autenticação.
4. Adicione um handler de rota para os endpoints de autenticação no framework backend escolhido.
5. Execute o comando de migração para configurar o esquema do banco de dados:

   npx @better-auth/cli@latest migrate
   

6. Verifique sua configuração acessando o endpoint de verificação de saúde:
   • GET /api/auth/ok deve retornar { status: "ok" }

Dicas de Configuração

• Defina baseURL e secret na configuração apenas se as variáveis de ambiente correspondentes não estiverem definidas.
• O CLI procura por auth.ts em locais padrão; use a flag --config para caminhos personalizados.
• Sempre execute novamente o comando de migração após adicionar ou alterar plugins.

Comandos Úteis do CLI

• npx @better-auth/cli@latest migrate — Aplica o esquema padrão
• npx @better-auth/cli@latest generate — Gera esquema para Prisma ou Drizzle
• npx @better-auth/cli mcp --cursor — Adiciona integração MCP para ferramentas de IA

Perguntas Frequentes

better-auth-best-practices é adequado para todos os projetos backend?

Esta skill é ideal para backends em TypeScript e Node.js que precisam de autenticação segura e flexível. Não é indicada para ambientes frontend ou que não usem TypeScript.

Quais variáveis de ambiente são necessárias?

Você deve definir BETTER_AUTH_SECRET (uma string segura e aleatória) e BETTER_AUTH_URL (a URL base da sua aplicação). São essenciais para o funcionamento seguro.

Onde devo colocar meu arquivo auth.ts?

O CLI procura auth.ts na raiz do projeto, ou nas pastas lib, utils ou src. Use a flag --config para especificar um local personalizado.

Como atualizo minha configuração após adicionar plugins?

Sempre execute novamente o comando de migração (npx @better-auth/cli@latest migrate) após adicionar ou modificar plugins para garantir que o esquema do banco esteja atualizado.

Onde encontro mais exemplos e documentação?

Visite better-auth.com/docs para os exemplos de código mais recentes, referências de API e guias avançados de configuração.