br-state-flags (Biblioteca)

br-state-flags é a biblioteca principal que fornece componentes React de alta fidelidade e pronta para produção com bandeiras SVG para todos os 27 estados brasileiros. É projetada para ser leve, sem dependências e inclui metadados geográficos e demográficos enriquecidos para cada estado. Para uma demonstração interativa, confira o projeto demo.

Principais Recursos

1. Cobertura Total dos Estados: Inclui bandeiras oficiais dos 26 estados e do Distrito Federal, com cores e proporções precisas.
2. Arquitetura Sem Dependências: Extremamente leve e otimizada, sem dependências externas. SVGs refinados para máximo desempenho.
3. Suporte Avançado a TypeScript: Construído com TypeScript para uma experiência de desenvolvimento superior. Tipos completos incluídos.
4. Integração Simplificada: Importe as bandeiras necessárias e utilize-as como componentes React padrão. Compatível com todas as propriedades SVG.

Stack Tecnológica

• Core: React, TypeScript
• Visuais: SVG (Alta fidelidade, otimizado para web)
• Compatibilidade: Suporta Next.js (App e Pages router) e Vite

Exemplo de Uso

npm install br-state-flags

import { AC, SP } from 'br-state-flags';
 
const MyComponent = () => (
  <div className="flex gap-4">
    <AC width={120} title="Acre" />
    <SP width={120} title="São Paulo" />
  </div>
);

A biblioteca também fornece metadados para cada estado:

import { statesData } from 'br-state-flags';
 
const spData = statesData.SP;
console.log(spData.capital); // "São Paulo"
console.log(spData.population); // 45919049