@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.