O design system da RivoCode, documentado por dentro.
149 peças sobre a Base UI, com tokens em três camadas e dois temas. Nenhum componente conhece a cor da marca: ele pede um papel, e o tema responde.
Os pacotes são privados, no GitHub Packages. O token e o resto do passo a passo estão na instalação.
149
peças no catálogo
147
com exemplo que roda
5252
testes verdes, web e nativo
15
guias de uso
Tokens
Trocar de cliente é trocar uma camada
A paleta guarda a cor crua. O papel diz para que ela serve. O tema decide qual cor responde a cada papel.
Componente nenhum atravessa essas camadas: o bun run check falha se alguém escrever uma cor literal, e o contraste de cada par de papéis é medido a cada commit.
A densidade compacta também é um atributo do Provider, e não um segundo catálogo: o guia de densidade mostra a mesma tela nas duas alturas.
--rc-p-lime-400a cor crua, sem opinião--color-accento papel que ela cumpre[data-rc-theme]quem decide, por clienteReact Native
A mesma peça no celular, sem um segundo catálogo
O @rivocode/ui-native traz 123 das 149 peças para o React Native, com os mesmos tokens, os mesmos dois temas e o mesmo vocabulário de classes: o NativeWind lê as classes que você já escreve aqui.
O que atravessa é o vocabulário, o token e a escolha da peça. O JSX se reescreve: no toque tudo é controlado, a lista vem por items em vez de composição, e as peças que não portam não portam por decisão: barra lateral, tabela e dica de ponteiro são idioma de mesa, e o celular tem o dele.
O guia do React Native traz a tabela peça a peça: o que traduz, o que está na fila e o que nunca vai portar.
@rivocode/ui<Select items={UFS} value={uf} onValueChange={setUf}>
<SelectTrigger>
<SelectValue />
</SelectTrigger>
<SelectContent>
{UFS.map((item) => (
<SelectItem key={item.value} value={item.value}>
{item.label}
</SelectItem>
))}
</SelectContent>
</Select>@rivocode/ui-native<Select
items={UFS}
value={uf}
onValueChange={setUf}
label="UF"
/>Agents
A mesma documentação, em markdown cru
Boa parte do código que usa esta biblioteca hoje é escrita com um agent ao lado. Um site que só serve HTML obriga o agent a adivinhar a API pelo nome, e ele adivinha com confiança.
Toda página tem o endereço cru em .md, com importação, exemplos e tabela de props. O índice fica em /llms.txt.
/componentes/data-table.md# DataTable
Listagem com os quatro finais de uma
consulta: carregando, deu certo, deu
errado, veio vazia.
## Importação
import { DataTable } from '@rivocode/ui'
## Props
| Prop | Tipo | Obrigatória |
| --------- | -------- | ----------- |
| data | Row[] | sim |
| columns | Column[] | sim |
| isLoading | boolean |, |Skill
Um comando, e o agente aprende a biblioteca
Colar o contrato no prompt funciona uma vez. Na segunda conversa ele não está lá, e o agent volta a adivinhar a API pelo nome.
A skill fica instalada, e leva junto a tabela de escolha entre as peças parecidas: Alert contra Toast, Select contra Combobox, com o porquê de cada linha.
.claude/skills/rivocode-ui/SKILL.md| Situação | Peça certa |
| --------------------------- | ------------- |
| Aviso que fica na tela | Alert |
| Confirmação destrutiva | AlertDialog |
| Poucas opções fixas | Select |
| Lista longa, ou do servidor | Combobox |
| Liga agora, sem confirmar | Switch |
## O que nunca fazer
- Cor literal em className ou style. Sempre token.
- z-index numérico. Sempre z-[var(--rc-z-*)].
- Altura cravada em controle.Base UI
O comportamento não é nosso, e essa é a vantagem
Foco, teclado, portal, leitor de tela e os casos de borda vêm da Base UI, que trata disso em tempo integral.
O que a biblioteca acrescenta é o desenho, e a decisão de quando cada peça serve. Duas linhas de CSS e um Provider, e a tela começa.
import '@rivocode/ui/styles.css'
import { RivoProvider } from '@rivocode/ui'
export function App() {
return (
<RivoProvider theme="rivocode-dark" density="comfortable">
<OrdersScreen />
</RivoProvider>
)
}O catálogo
Por família, na ordem de quem monta uma tela.
Fundação1
Tipografia5
Formulário43
- AudioRecorder
- Autocomplete
- Calendar
- Checkbox
- CheckboxCard
- CheckboxGroup
- ColorPicker
- Combobox
- CurrencyInput
- DatePicker
- DateRangePicker
- DateTimePicker
- Editable
- Field
- Fieldset
- FileUpload
- Form
- Input
- InputGroup
- MaskedInput
- MonthPicker
- NumberField
- OTPField
- PasswordInput
- PostalCodeField
- Questionnaire
- RadioCard
- RadioGroup
- Rating
- RichTextEditor
- SaveBar
- SearchInput
- Select
- SignaturePad
- Slider
- Switch
- TagsInput
- Textarea
- TimeField
- TimePicker
- TransferList
- Tree
- TreeSelect
Estrutura27
Feedback17
Comece pela instalação
Um comando, as duas linhas de CSS e o Provider. Depois disso é escrever tela.