@amfernandesinc/ui

Component library para softwares enterprise da AM Fernandes Incorporadora. React 19, Tailwind v4, light-only, flat, WCAG AA.

Instalação

bun add @amfernandesinc/ui

Peer deps: react@^19, react-dom@^19, tailwindcss@^4.

Setup

Importe os estilos e fontes no entrypoint da app (uma vez, no main.tsx ou no CSS principal):

import "@amfernandesinc/ui/styles"
import "@amfernandesinc/ui/fonts"

As famílias Geist e Geist Mono são self-hosted via @fontsource/geist e @fontsource/geist-mono — vêm como dependências do pacote, sem chamadas externas a Google Fonts.

Importação

Suporta tanto barrel quanto subpath imports por componente:

// Tree-shake-friendly: barrel
import { Button, DataTable } from "@amfernandesinc/ui"

// Per-component: subpath
import { Button } from "@amfernandesinc/ui/button"

Componentes (47 no total)

| Categoria | Count | Componentes | | ---------- | ----- | ---------------------------------------------------------------------------------------------------- | | Primitives | 12 | Avatar, Badge, Button, Checkbox, Input, Label, RadioGroup, Separator, Skeleton, Switch, Textarea, Typography | | Overlays | 9 | Alert, AlertDialog, Collapsible, Dialog, Popover, Progress, Sheet, Toaster, Tooltip | | Forms | 5 | Calendar, Combobox, DateInput, DateRangePicker, TimePicker | | Navigation | 5 | Accordion, Breadcrumb, CommandPalette, Sidebar, Tabs | | Data | 7 | Card, DataTable, Image, ScrollArea, Tree, Video + helpers columns / tableStyles | | Domain | 9 | CEPInput, CNPJInput, CPFInput, CurrencyInput, FileUpload, InputOTP, MultiInput, PercentageInput, PhoneInput |

Helpers utilitários (BRL em centavos, tamanhos em bytes, cn, hooks) estão documentados na aba Hooks do Storybook.

Filosofia

• Light only, flat — sem shadows, sem dark mode (decisão de produto).
• 4px radius uniforme, densidade enterprise (text-sm no body, py-3 nos inputs).
• WCAG AA de contraste e foco; cursor pointer em tudo que é clicável.

Documentação

• Storybook local: bun run storybook (http://localhost:6006).
• Contribuição: CONTRIBUTING.md.
• Histórico de versões: CHANGELOG.md.

Status

v0.0.2 — pre-release. Próximo release: v0.1.0 via bun run changeset:version.