Pular para o conteúdo
Feedback

Bacalhau

/componentes/bacalhau.mdmarkdown cru, para quem lê com agent em vez de olho

Dando oi

Página não encontrada

Erro 404

Esta página foi pescada

O endereço pode ter mudado ou ter sido digitado errado. O Bacalhau procurou e não achou nada aqui.

Busca sem resultado

Nada com esse nome

Tente outra palavra, ou procure pelo nome da peça.

Deu certo, com confete

Carregando

Um instante, estou nadando até lá.

Perfil do chat que troca de pose

Bacalhaumascote da RivoCode

Espiando por cima da borda

Por cima de um painel, entrando e saindo de cena

A cabeça fica atrás da borda do cartão, e as mãos, na frente dela.

Os chapéus de festa

As 36 poses

standing
waving
celebrating
thinking
pointing
coding
support
sleeping
surprised
sad
reading
searching
launching
winking
goodbye
trophy
builder
love
walking
walkingAway
thumbsUp
idea
shrug
presenting
checklist
mail
calendar
wrenchGear
shield
cloud
aiChip
bell
gift
offline
locked
emptyBox
Importar
import { Bacalhau } from '@rivocode/ui/mascot'

Quando usar

O Bacalhau é o mascote da RivoCode: um bacalhau chibi, cor de limão, de olhos grandes e bochechas rosadas. São 36 poses do mesmo corpo na mesma caixa, quatro chapéus de festa, os movimentos que dão vida a ele e a versão que espia por cima de uma borda, o BacalhauPeek. Vive em @rivocode/ui/mascot, fora do índice da raiz, para quem não mostra o mascote não pagar pelo desenho.

import { Button, Result } from '@rivocode/ui'
import { Bacalhau } from '@rivocode/ui/mascot'

<Result
  layout="page"
  titleAs="h1"
  illustration={<Bacalhau pose="searching" size="xl" />}
  meta="Erro 404"
  title="Esta página foi pescada"
  description="O endereço pode ter mudado ou ter sido digitado errado."
  actions={<Button>Voltar ao início</Button>}
/>

Ele é o rosto da marca, e não o logo. O logo da RivoCode continua sendo as ondas. O Bacalhau aparece onde a conversa é com uma pessoa: a página que não existe, a busca que não achou, o envio que deu certo, o chat que pergunta.

Em produto da RivoCode, todo estado desenhado é dele. Onde a tela de um cliente põe uma Illustration, a da RivoCode põe o Bacalhau, no mesmo tamanho:

Situação Illustration Bacalhau
Página que não existe NotFound pose="searching"
Sem permissão Forbidden pose="locked"
Falhou do nosso lado ServerError pose="sad" motion="shake"
Consulta que falhou, na página ou na seção ServerError no errorIllustration pose="sad" motion="shake" no errorIllustration
Sem conexão Offline pose="offline"
Em manutenção Maintenance pose="builder"
Vazio de primeira vez EmptyList pose="emptyBox"
Busca sem resultado NoResults pose="shrug"
Tudo lido EmptyInbox pose="thumbsUp"
Sem dado no período NoData pose="calendar"

O vazio pequeno, numa coluna ou num cartão estreito, fica no icon do EmptyState, sem mascote. No produto de um cliente ele não entra: as cores dele são as da RivoCode, e não mudam com o tema.

As poses

Toda pose é o mesmo bacalhau fazendo outra coisa: mudam os braços, o rosto e um adereço, e o corpo, as cores e a caixa ficam. Trocar de pose não pula. A cauda bifurcada sai de lado e a barbatana de vela fica no topo: é por elas que ele se lê como peixe, até em 40px. A emoção mora no corpo inteiro: no triste a pálpebra cai e o corpo achata, no surpreso o olho cresce e o corpo estica, no preocupado a pupila encolhe e aparece a gota de suor. MASCOT_POSES lista as 36, na ordem da galeria:

Na interface - as que respondem a um momento do produto: os quatro momentos de uma ação, o vazio, o erro e a conversa.

pose O que ele faz Onde cabe
standing Em pé, à vontade O padrão. Qualquer lugar onde ele só precisa estar
waving Dando oi, a mão acena Boas-vindas, abrir uma conversa, despedida
celebrating Comemorando, os brilhos piscam Deu certo: mensagem enviada, projeto no ar
thinking Pensando, o balão aparece em bolinhas Enquanto ele "digita", perguntas frequentes
pointing Apontando para o lado esquerdo da tela Chamar atenção para um campo ou uma seção à esquerda dele
coding Programando, as mãos digitam Enviando, carregando, "como trabalhamos"
support Atendendo, de fone Atendimento, contato, suporte
sleeping Dormindo, os "z" sobem Fora do horário, nada acontecendo
surprised Surpreso, as linhas de susto pulsam Novidade, resultado inesperado
sad Tristinho, com uma lágrima, olhando para baixo Erro no envio, página 404
searching Com a lupa, que procura Busca, diagnóstico
launching Lançando o foguete, que decola Entrega, projeto no ar, app publicado
winking Piscando Dica escondida, "deixa com a gente"
goodbye Tchau, de costas Fim de conversa, "até a próxima"
builder De capacete de obra Em construção, manutenção
walking Andando, os pés se alternam A caminho, "estou indo aí"
walkingAway Andando, de costas Saindo: seguir para outro canal
thumbsUp Beleza: a mão erguida, firme, e uma piscada Aprovado, etapa concluída
idea Tive uma ideia Dica, insight
shrug Não sei, ombros erguidos Busca sem resultado, "ainda não sei bem"
checklist Com a prancheta Escopo, processo, entregas
mail Chegou e-mail Confirmação de envio
calendar Com o calendário Prazo, agendamento
shield Com o escudo Segurança, LGPD, backup
bell Tocando o sino Notificação, lembrete
offline Olhando o sinal de rede cortado Sem conexão; o par da Offline
locked Segurando o cadeado Sem permissão, área restrita; o par da Forbidden
emptyBox Olhando dentro da caixa vazia Vazio de primeira vez, nada criado ainda; o par da EmptyList

No site e na comunicação - as que contam o que a RivoCode faz. Cabem na página institucional, na proposta e na rede social, e não respondem a nenhum estado de tela.

pose O que ele faz Onde cabe
reading Lendo, de óculos Termos, contratos, "lendo com você"
trophy Com o troféu Meta batida, resultado alcançado
love Com coração, que bate Agradecimento, cliente novo
presenting Segurando o quadro do gráfico Relatório, painel, resultado
wrenchGear Ajustando as engrenagens, que giram Ajustes, melhoria contínua
cloud Com a nuvem Hospedagem
aiChip Com o chip de IA IA aplicada, automação
gift Com um presente Datas especiais, cliente novo

Nome desconhecido cai em standing, e não quebra a tela.

Espiando

BacalhauPeek é ele por cima de uma borda: só a cabeça e as mãos, agarradas na beirada. A borda de baixo do desenho é a borda por onde ele espia, então encoste-o no topo de um painel, de um cartão ou da tela. Ao montar ele sobe com cautela, olha para um lado e para o outro e agarra a borda; depois flutua e pisca. happy fecha os olhos em arco e ele sorri.

Passe o painel como children e ele passa entre as duas camadas: a cabeça atrás da beirada, as mãos na frente. visible o põe e o tira de cena, followPointer faz os olhos seguirem o ponteiro e shy o faz fugir dele; a página do BacalhauPeek tem cada uma.

import { BacalhauPeek } from '@rivocode/ui/mascot'

<BacalhauPeek size="sm" happy={hovering} visible={onStage} followPointer>
  <Card>...</Card>
</BacalhauPeek>

Chapéus e o calendário

hat veste um dos quatro chapéus de MASCOT_HATS, cada um com a festa em volta: party (Carnaval, com confete e serpentina), straw (São João, com o varal de bandeirinhas), santa (Natal, com neve) e newyear (Réveillon, com fogos). O chapéu vai de lado e deixa a barbatana da cabeça à vista. Na pose builder o capacete já é o chapéu, e hat fica de fora.

hat="season" escolhe pela data de hoje no aparelho de quem vê, e ninguém precisa publicar nada em cada festa:

Chapéu Quando
party Do sábado à quarta-feira de cinzas, calculado pela Páscoa a cada ano
straw O mês de junho inteiro
santa De 1 a 25 de dezembro
newyear De 26 de dezembro a 1º de janeiro

Fora dessas datas, sem chapéu. No navegador a data só é lida depois de montar, então a página pré-renderizada não guarda o dia do build. seasonHat(date) faz a mesma conta para quem quer decidir por conta própria.

Movimento

As partes da pose se mexem sozinhas: a mão acena, os brilhos piscam, os "z" sobem, o foguete decola, a lupa procura, os pés andam e a barbatana vem um instante depois. animated={false} desenha a pose parada.

O corpo inteiro se mexe com motion, um dos seis de MASCOT_MOTIONS:

motion O que faz Para quê
breathe Infla e desinfla devagar Parecer vivo mesmo parado: a espera
bounce Quica no lugar O que deu certo, junto com celebrating
shake Uma tremidinha, duas vezes O erro, junto com sad
swim Balança como na água O carregando
hop Um pulinho A troca de pose num perfil de chat
flip Um mortal O momento raro, um easter egg

confetti solta uma chuva de confete nas cores da marca de trás dele, uma vez, em 1,6 s. Confete é só para o que deu certo de verdade.

Nada fica em laço sem pedir. O que repete toca o que cabe em 5 s e para no repouso, dentro da WCAG 2.2.2, que pede pausa para movimento automático mais longo que isso. loop mantém rodando, e serve só à tela de carregamento, em que o movimento é o próprio aviso de espera.

Reduzir movimento. Com a preferência do sistema ligada, tudo nasce parado e o confete não aparece, sem precisar desligar nada. Os quadros vêm junto com a peça, e não na styles.css: quem não usa o mascote não baixa nenhum deles.

import { Bacalhau } from '@rivocode/ui/mascot'

<div role="status" className="flex flex-col items-center gap-2">
  <Bacalhau pose="walking" motion="swim" loop />
  <span>Um instante, estou nadando até lá.</span>
</div>

Medidas

size escolhe a altura, e a largura sai da caixa do desenho:

  • xs, 40 px: o avatar de um chat.
  • sm, 64 px: ao lado de um texto, numa lista.
  • md, 112 px (o padrão): o vazio de uma seção.
  • lg, 160 px: o centro de uma tela.
  • xl, 224 px: a página inteira, como o 404.

O BacalhauPeek mede pela largura: sm 80, md 128 (o padrão) e lg 176.

Cor

As cores são da marca e fixas, e não mudam com o tema: o limão do corpo, o verde das barbatanas e das pintinhas, a tinta do contorno, o rosa das bochechas, e os tons dos adereços. Elas moram em src/tokens/mascot.ts, o único lugar de onde a biblioteca tira cor literal. No escuro a silhueta é o limão contra o fundo; no claro, o contorno de tinta. Não recolora o Bacalhau.

Acessibilidade

O desenho é decorativo e sai com aria-hidden: quem diz o que houve é o texto ao lado. Quando o desenho é a mensagem, dê um label, e ele vira imagem com esse nome.

Classe por parte

classNames alcança art (o <svg>) e confetti (a caixa onde o confete cai, para alargá-la além do desenho com um -inset-*). O className vai na caixa de fora.

Regras do personagem

  • Um bacalhau por vez na tela. Dois na mesma tela deixam de ser um personagem e viram decoração.
  • Ele reage ao que aconteceu de verdade. Pensa enquanto carrega, comemora quando dá certo, fica triste no erro. Nunca comemora o que não aconteceu.
  • Fala curto, em português simples, com bom humor. Um trocadilho de peixe de vez em quando, não em toda frase. Nunca inventa depoimento, número ou cliente.
  • Sempre o mesmo personagem: cabeça grande, olhos do mesmo tamanho, dois brilhos em cada um, bochechas rosadas. Não distorça, não recolora e não deite.

Quando não usar

  • Tela de erro e de vazio dentro do produto de um cliente é a Illustration. Ela troca de cor com o tema do cliente; o Bacalhau é da RivoCode e não troca.
  • Carregando dentro de uma tela que já tem conteúdo é Skeleton ou Spinner. O mascote nadando é para a tela inteira que ainda não tem nada.
  • A pessoa do outro lado é Avatar. O mascote não representa usuário nenhum.
  • A assinatura da empresa é o logo de ondas, e não o Bacalhau.

No React Native

Traduz em @rivocode/ui-native/mascot, com o Bacalhau e o BacalhauPeek e as mesmas props do web: pose (as 36 de MASCOT_POSES), hat (os quatro de MASCOT_HATS, e o season), motion (os seis de MASCOT_MOTIONS), animated, loop, confetti, size e label. A geometria é a mesma do web, dividida em shared/mascot.ts: o Bacalhau do celular é o do navegador, traço a traço.

Desenha com o react-native-svg, peer da raiz, o mesmo do /chart e das ilustrações, e mora em caminho próprio pelo peso. As cores são da marca e não mudam com o tema: saem de tokens.mascot, geradas da mesma paleta do web.

import { Bacalhau, BacalhauPeek } from "@rivocode/ui-native/mascot";

<Bacalhau pose="celebrating" motion="bounce" confetti />
<BacalhauPeek size="sm" hat="season" />

Os movimentos tocam no react-native-reanimated que o pacote já usa, com os quadros de MASCOT_CHOREOGRAPHY, a mesma tabela de onde o web gera o CSS. Cada parte que se mexe é uma camada própria, com o pivô no mesmo ponto do desenho. O que repete para em 5 s, como no web, a não ser com loop. Com "reduzir movimento" do sistema tudo nasce parado e o confete não sai. O desenho fica escondido do leitor de tela até ganhar label, e então vira image com esse nome. O Bacalhau não tem classNames: o className veste a caixa de fora.

O BacalhauPeek traz as duas camadas do web, a cabeça e as mãos, com classNames de head, hands e edge, e o painel entra por children, entre elas; align e visible também atravessam, e fora de cena ele desce para trás da borda e some do leitor de tela. A reserva do lugar da cabeça fica no web por enquanto: lá a moldura soma no topo a altura da cabeça, e overlap desliga; no nativo a cabeça ainda sobe por cima do que vem antes, e quem monta abre o vão com mt-* na moldura. followPointer e shy ficam no web: são reações ao ponteiro de mesa, e no toque não há ponteiro pairando para seguir nem de que fugir - o dedo só existe quando já tocou.

API

PropTipoPadrão
animated

As partes da pose se mexem sozinhas: a mao acena, os brilhos piscam, o foguete decola, os pes andam.

booleantrue
classNames

Classe por parte: `art` e o `<svg>`, `confetti` e a caixa do confete.

Partial<Record<"art" | "confetti", string>>sem padrão
confetti

Uma chuva de confete nas cores da marca sai de tras dele ao montar, uma vez, em 1,6 s.

booleanfalse
hat

O chapeu de festa: `party` (Carnaval), `straw` (Sao Joao), `santa` (Natal) ou `newyear` (Reveillon).

"newyear""party""santa""season""straw"sem padrão
label

O nome do desenho para o leitor de tela.

stringsem padrão
loop

Sem `loop`, o movimento que repete toca o que cabe em 5 s e para no quadro de repouso, dentro da WCAG 2.2.2.

booleanfalse
motion

O movimento do corpo inteiro: `breathe` (respira, para a espera), `bounce` (quica, para o que deu certo), `shake` (treme duas vezes, para o erro), `swim` (nada, para o carregando), `hop` (pulinho, para a troca de pose) ou `flip` (o mortal).

"bounce""breathe""flip""hop""shake""swim"sem padrão
pose

O que ele esta fazendo, entre as 36 poses de `MASCOT_POSES`.

"aiChip""bell""builder""calendar""celebrating""checklist""cloud""coding""emptyBox""gift""goodbye""idea""launching""locked""love""mail"... 20 more ..."standing"
size

A altura: `xs` 40px (o avatar de um chat), `sm` 64px, `md` 112px, o padrao, `lg` 160px e `xl` 224px (a pagina inteira, como o 404).

MascotSize"md"

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

Partes

Bacalhau se monta com estas peças. Todas vivem nesta página, porque separar cada uma num endereço obrigaria a abrir seis abas para montar uma tela.

BacalhauPeek

/bacalhau-peek.md

O Bacalhau espiando por cima de uma borda: só a cabeça e as mãos, agarradas na beirada. É o jeito de sempre dele no site da RivoCode, em cima do painel da página inicial e no canto da tela.

import { BacalhauPeek } from '@rivocode/ui/mascot'

<div className="flex justify-end border-b border-border">
  <BacalhauPeek size="sm" hat="season" />
</div>

A borda de baixo do desenho é a borda por onde ele espia: o que passa dela fica cortado, e é assim que ele sobe "de trás" da beirada. Encoste-o no topo de um painel, de um cartão ou da tela.

Ao montar, ele sobe com cautela até os olhos passarem da borda, olha para um lado e para o outro, e só então aparece inteiro e agarra a beirada. Depois flutua devagar e pisca. Com "reduzir movimento" ele já nasce no lugar, parado, e animated={false} faz o mesmo numa instância. Como no Bacalhau, o que repete para depois de 5 s, a não ser com loop.

happy fecha os olhos em arco e ele sorri: para o ponteiro que chega perto, ou para a conversa que ele abre estar aberta. hat aceita os mesmos quatro chapéus e o season. size mede pela largura: sm 90 px, md 144 px (o padrão) e lg 198 px.

Por cima de um painel

O desenho vem em duas camadas: a cabeça (head), um <svg> cortado na borda de baixo, e as mãos (hands), que passam um pouco dela para a ponta cair por cima da beirada. Passe o painel como children e a peça vira a moldura dele: a cabeça vem antes do painel, as mãos depois, e o painel passa entre as duas, sem z-index nenhum. Ele espia pela borda de cima do painel, a 12% da ponta; align escolhe start, center ou end (o padrão).

import { BacalhauPeek } from '@rivocode/ui/mascot'
import { Card } from '@rivocode/ui'

<BacalhauPeek size="sm" hat="season" align="end">
  <Card>...</Card>
</BacalhauPeek>

A moldura reserva o lugar da cabeça. Com children, a peça soma no topo a altura da cabeça no size escolhido (71, 114 e 156 px), e a cabeça mora nesse espaço: não cobre o título nem nada que venha antes. Não precisa mais de className="mt-12" para abrir o vão. Quando a cabeça deve subir por cima do que está ali de propósito, sobre um vão que já existe, passe overlap.

<Heading>Seu painel</Heading>
<BacalhauPeek size="sm" align="start">
  <Card>...</Card>
</BacalhauPeek>

A cabeça corta na própria borda de baixo, e as mãos só passam dela a altura da ponta que agarra: ao descer, elas soltam e somem sem atravessar o painel. Quer a cabeça inteira atrás de um painel opaco, sem o corte? classNames={{ head: 'overflow-visible' }}: o painel, que vem depois dela, a cobre. Sem children, as duas camadas ficam empilhadas numa caixa só, e a borda de baixo da caixa é a borda por onde ele espia, como sempre.

Entrar e sair de cena

visible é controlado por quem usa. true sobe com a mesma entrada da montagem; false desce para trás da borda em 0,3 s, as mãos soltam por último, e ele some do leitor de tela. Sem a prop ele fica em cena. Quando houver mais de um lugar onde ele pode espiar, quem decide qual aparece é o app: um mascote só na tela.

const [onStage, setOnStage] = useState(false)

<BacalhauPeek visible={onStage} followPointer shy>
  <Card>...</Card>
</BacalhauPeek>

followPointer faz as pupilas seguirem o ponteiro na janela, cada olho no seu passo, com alcance curto: não passam da borda do olho. shy o deixa tímido: quando o ponteiro chega a menos de 90 px dos olhos ele desce, e volta 1,6 s depois com a entrada cautelosa, no máximo uma fuga a cada 2,6 s. As duas são do ponteiro de mesa e ficam paradas com "reduzir movimento" ou com animated={false}, que também faz visible trocar sem animar.

Quando não usar

Para o mascote inteiro, numa tela de vazio, de erro ou de sucesso, é o Bacalhau. O BacalhauPeek é só o espiar por cima de uma borda.

Acessibilidade

É decorativo e sai com aria-hidden; com label, a cabeça vira a imagem com esse nome, e as mãos continuam escondidas. Quando ele é o botão que abre a conversa, o nome vai no botão em volta, e não no desenho. Fora de cena ele some do leitor de tela junto com a tela.

PropTipoPadrão
align

Onde ele espia, ao longo da borda de cima de `children`: `start` e `end` a 12% da ponta, `center` no meio.

"center""end""start""end"
animated

Ao montar ele sobe de tras da borda com cautela, olha para um lado e para o outro, e agarra a borda; depois flutua e pisca.

booleantrue
classNames

Classe por parte: `head` e a camada da cabeca, que corta na borda de baixo com `overflow-hidden`; `hands` a das maos, que passa um pouco da borda para a ponta cair por cima dela; `edge` a caixa em volta de `children`.

Partial<Record<"edge" | "hands" | "head", string>>sem padrão
followPointer

As pupilas seguem o ponteiro na janela, cada olho no seu passo, ate 5 e 6,5 unidades do desenho.

booleanfalse
happy

Os olhos fecham em arco e ele sorri: para quando o ponteiro chega, ou quando a conversa que ele abre esta aberta.

booleanfalse
hat

O chapeu de festa, com os mesmos valores do `Bacalhau`, `season` incluido.

"newyear""party""santa""season""straw"sem padrão
label

O nome do desenho para o leitor de tela.

stringsem padrão
loop

O flutuar e o piscar continuam depois dos 5 s.

booleanfalse
overlap

Com `children`, a peca reserva acima do painel a altura da cabeca no `size` escolhido (71, 114 e 156px, a altura da caixa do desenho), e ela nao cobre o que vem antes.

booleanfalse
shy

Timido: quando o ponteiro chega a menos de 90px dos olhos ele desce, e volta 1,6 s depois com a entrada cautelosa.

booleanfalse
size

A largura: `sm` 90px, `md` 144px, o padrao, e `lg` 198px.

MascotPeekSize"md"
visible

Se ele esta em cena, controlado por quem usa: `true` sobe com a mesma entrada da montagem, `false` desce para tras da borda em 0,3 s e some do leitor de tela.

booleansem padrão

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

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