Pular para o conteúdo

Início rápido

Uma tela de verdade: formulário que valida e listagem com os estados.

/inicio-rapido.mdmarkdown cru, para quem lê com agent em vez de olho

Uma tela de verdade, do zero, com os pedaços que quase toda tela de aplicação tem: um formulário que valida, uma listagem que sabe carregar e falhar, e um aviso no fim.

Se ainda não instalou, comece pela Instalação.

O esqueleto

import { RivoProvider } from '@rivocode/ui'
import './styles.css'

export function App() {
  return (
    <RivoProvider theme="rivocode-dark">
      <OrderScreen />
    </RivoProvider>
  )
}

Um formulário que valida

O subcaminho @rivocode/ui/form junta React Hook Form e Zod. O schema é a fonte da verdade: ele valida e ainda dá o tipo do formulário.

import { Button, Input } from '@rivocode/ui'
import { Form, FormField, useZodForm } from '@rivocode/ui/form'
import { z } from 'zod'

const schema = z.object({
  email: z.string().email('Informe um e-mail válido'),
  amount: z.string().min(1, 'Informe o valor'),
})

function OrderForm({ onPlace }: { onPlace: (data: unknown) => void }) {
  const form = useZodForm(schema)

  return (
    <Form form={form} onSubmit={onPlace}>
      <FormField name="email" label="E-mail do cliente" description="Para onde vai a confirmação do pedido">
        {(field) => <Input {...field} type="email" placeholder="nome@empresa.com.br" />}
      </FormField>

      <FormField name="amount" label="Valor">
        {(field) => <Input {...field} placeholder="0,00" />}
      </FormField>

      <Button type="submit" loading={form.formState.isSubmitting}>
        Registrar pedido
      </Button>
    </Form>
  )
}

O FormField não inventa id. Ele monta rótulo, controle, ajuda e erro dentro do Field, e a Base UI liga aria-describedby e aria-invalid sozinha para qualquer controle dela que esteja lá dentro.

Uma listagem que conhece os quatro finais

Toda consulta tem quatro finais: carregando, deu certo, deu errado, e veio vazia. O DataTable recebe os quatro e desenha cada um, sem a biblioteca saber o que é React Query.

import { Badge, DataTable } from '@rivocode/ui'

function OrderList({ query }) {
  return (
    <DataTable
      data={query.data}
      isLoading={query.isLoading}
      isError={query.isError}
      onRetry={query.refetch}
      rowKey={(order) => order.id}
      empty={{
        title: 'Nenhum pedido por aqui',
        description: 'Quando a loja vender pela primeira vez, o pedido aparece nesta lista.',
      }}
      columns={[
        { key: 'number', header: 'Número' },
        { key: 'customer', header: 'Cliente' },
        { key: 'amount', header: 'Valor', align: 'right' },
        {
          key: 'status',
          header: 'Situação',
          align: 'right',
          cell: (order) => <Badge tone={order.paid ? 'success' : 'neutral'}>{order.status}</Badge>,
        },
      ]}
    />
  )
}

Funciona igual com fetch na mão, com SWR ou com server component: o que a tabela quer são os três sinais, não a biblioteca que os produziu.

hideOnMobile numa coluna some com ela na tela estreita, use para o que dá para descobrir de outro jeito.

Avisar sem montar portal

import { Button, useToast } from '@rivocode/ui'

function ShipButton() {
  const toast = useToast()

  return (
    <Button
      onClick={async () => {
        await ship()
        toast.add({
          title: 'Pedido 4816 despachado',
          description: 'O código de rastreio foi enviado para o e-mail do cliente.',
        })
      }}
    >
      Despachar
    </Button>
  )
}

O viewport de avisos já está montado pelo Provider. Você chama add e o aviso aparece no canto.

O que ler depois

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.