Documentação Nulvless

Como colocar identidade no seu produto — login e permissões, quickstarts por framework, a referência do SDK e a plataforma em volta disso.

Introdução

nulvless é infraestrutura de identidade para SaaS. Ele resolve as partes de um produto que todo time acaba construindo e ninguém quer manter: colocar as pessoas para dentro, decidir o que elas alcançam, enviar as mensagens de que esses fluxos dependem, e guardar o registro do que aconteceu.

A integração é por um SDK só. Todo o resto — provedores, templates, papéis, rate limits, ambientes — é configuração que você muda sem publicar código.

Quickstart

Crie um client e autentique seu primeiro usuário.

Fundamentos

Projetos, ambientes, identidades, grants e chaves.

Construa com um agente

Passe isto para o seu agente (Claude Code, Cursor, Codex) ou chat antes de pedir código. O prompt manda o agente para esta documentação e define as regras que ele não pode quebrar.

Prompt para agentes

Estou construindo um app com o nulvless (login, sessões, MFA, permissões,
e-mail/SMS) usando o SDK `@nulvless/nulvless-js`.

Leia a documentação antes de escrever código e use só o que ela descreve. Se
algo não estiver documentado, me avise — nunca invente método, opção ou
endpoint.

- Documentação: https://www.nulvless.com/pt/docs
- Todas as páginas: https://www.nulvless.com/pt/llms.txt
- Tudo em um arquivo: https://www.nulvless.com/pt/llms-full.txt
- Qualquer página em Markdown: https://www.nulvless.com/pt/llms.mdx/docs/<path>/content.md

Comece por quickstart, api-keys, sdk, sdk/errors e
frameworks/<react|nextjs|vue|angular|html|node|express|fastify>.

Sempre:
- Mantenha a chave secreta (`sk-…`) e o `createServerClient` só em código de
  servidor. Nunca em código de cliente, em variável `NEXT_PUBLIC_`/`VITE_` ou
  no repositório. Só a chave publicável (`pk-…`) chega ao navegador.
- Leia chaves e URLs de variáveis de ambiente e liste-as em `.env.example` com
  placeholders.
- Verifique permissões no servidor, não só na interface.
- Nunca registre em log nem coloque em URL uma chave, token ou código de uso
  único.
- Antes de escrever código, pergunte qual framework eu uso e se ele roda no
  navegador ou no servidor.
- Responda em português; código e nomes em inglês.

Mais prompts e um checklist de revisão: Vibe coding.

Quickstarts por framework

Todos terminam com a mesma coisa funcionando: cadastro, entrada, um segundo fator e uma rota que redireciona quando a sessão acaba.

React

A sessão sobrevive ao reload, as rotas redirecionam quando ela acaba.

Next.js

Dois clients, separados para a chave secreta não chegar ao navegador.

Vue

Um composable compartilhado por todos, mais os guards de rota.

Angular

Signals para a sessão, um guard e um interceptor de token.

HTML

Um arquivo, de uma CDN. Sem bundler, sem framework, sem build.

Node

O modelo do servidor, antes de qualquer framework embrulhá-lo.

Express

Um middleware autentica, outro autoriza.

Fastify

Um plugin decora a requisição, hooks barram a rota.

Referência

SDK JavaScript

@nulvless/nulvless-js — navegador e servidor. Disponível em inglês.

O que tem na plataforma

Autenticação — senhas, provedores sociais, passwordless e multifator, com sessões que registram dispositivo, localização e os métodos usados para chegar até elas.

Autorização — controle de acesso baseado em papéis, onde o papel é concedido sobre um recurso e carrega escopos, então a mesma pessoa pode ter acessos diferentes em cada lugar.

Modo sudo — uma confirmação nova na frente de ações sensíveis, inclusive as que o seu próprio produto considera perigosas.

OAuth server — seu projeto como issuer OAuth 2.1 e OpenID Connect em conformidade, para outras aplicações entrarem com você.

Edge functions — seu TypeScript rodando ao lado dos dados de identidade que ele lê, com a sessão já resolvida na requisição.

Comunicações — templates de e-mail e SMS por canal e por idioma, enviados pelos seus próprios provedores.

Observabilidade — monitoramento e uma trilha consultável de cada requisição que a plataforma serviu.

Sobre esta documentação

Os guias e as páginas de início estão em inglês e português. Use o seletor de idioma na barra lateral. A referência do SDK é mantida só em inglês.