✨ Open-Source

br-docs
validação completa de documentos brasileiros

Instalar agora (npm)
npm install br-docs

Funcionalidades

Tudo que você precisa para trabalhar com documentos brasileiros com segurança e performance.

Cadastro de Pessoa Física
CNPJ
Telefone
E-mail
Boleto
Cadastro de Pessoa Física
CNPJ
Telefone
E-mail
Boleto
Cadastro de Pessoa Física
CNPJ
Telefone
E-mail
Boleto
Código de Endereçamento Postal
Carteira Nacional de Habilitação
Chave PIX
Boleto
Código de Endereçamento Postal
Carteira Nacional de Habilitação
Chave PIX
Boleto
Código de Endereçamento Postal
Carteira Nacional de Habilitação
Chave PIX
Boleto

Validação Completa

Valide CPF, CNPJ, CEP, CNH, telefone, e-mail, PIX, boletos e códigos de barras com precisão e um único clique.

Altíssima Performance

Desempenho otimizado para aplicações de alta demanda, garantindo respostas rápidas e eficientes.

Nov 30 2025 09:12 AM

Commit inicial do projeto

Aline Monteiro • aline@mockdev.app
Dez 02 2025 02:45 PM

Pull request preparado para revisão

Diego Lima • diego@mockdev.app
Dez 03 2025 04:10 PM

Merge realizado e deploy automático

Marcela Rocha • marcela@mockdev.app

Open-Source

Comunidade ativa, GitHub aberto e contribuições guiadas pela transparência e segurança.

Zero Dependências

Pacote leve que roda sem nada além do Node.js, ideal para embarcar em qualquer projeto.

Por que usar o br-docs?

O br-docs elimina códigos duplicados, regras frágeis e regex perdido no projeto — entregando validações precisas, padronizadas e testadas para CNPJ, CPF, CEP, CNH, boleto, telefone e muito mais.

mais de
0,0
k
downloads no npm
menos
0
%
linhas de código
mais de
0
+
documentos brasileiros
open-source
0
%
projeto gratuito

before.ts

br-docs.ts

1function validateCPF(value: string) {
2  const clean = value.replace(/\\D/g, "")
3  if (clean.length !== 11 || /(\\d)\\1{10}/.test(clean)) return false
4
5  const calcDigit = (slice: number) => {
6    let sum = 0
7    for (let i = 0; i < slice; i++) {
8      sum += Number(clean[i]) * (slice + 1 - i)
9    }
10    const rest = (sum * 10) % 11
11    return rest === Number(clean[slice])
12  }
13
14  return calcDigit(9) && calcDigit(10)
15}
16
17const normalisePhone = (phone: string) => {
18  const clean = phone.replace(/\\D/g, "")
19  if (clean.length !== 11) throw new Error("Telefone inválido")
20  return "(" + clean.slice(0, 2) + ") " + clean.slice(2, 7) + "-" + clean.slice(7)
21}
1import { Cpf, Cnpj, Pix } from "br-docs";
2
3Cpf.isValid("123.456.789-09"); // true
4
5Cnpj.isValid("11.222.333/0001-81"); // true
6
7Cnh.isValid("12345678901"); // true
8
9Pix.isValid("123.456.789-09"); // true
10Pix.isValid("test@example.com"); // true

Instalação Rápida

npm install br-docs

Lightweight

~20KB minificado. Sem impacto na performance da sua app.

Instantâneo

Zero configuração. Comece a usar imediatamente.

Seguro

Sem requisições externas. Tudo roda localmente.

O que Developers Dizem

Feedback de profissionais que usam br-docs

João Silva

Desenvolvedor Full Stack

"Simples, rápido e funciona perfeitamente! Economizei horas de desenvolvimento."

Maria Santos

Arquiteta de Software

"Zero dependências externas? Perfeito! Exatamente o que precisávamos em produção."

Pedro Oliveira

Tech Lead

"Uso em todos os meus projetos. A documentação é clara!"