Bacalhau
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
Perfil do chat que troca de pose
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
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 é
SkeletonouSpinner. 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
| Prop | Tipo | Padrão |
|---|---|---|
animatedAs partes da pose se mexem sozinhas: a mao acena, os brilhos piscam, o foguete decola, os pes andam. | boolean | true |
classNamesClasse por parte: `art` e o `<svg>`, `confetti` e a caixa do confete. | Partial<Record<"art" | "confetti", string>> | sem padrão |
confettiUma chuva de confete nas cores da marca sai de tras dele ao montar, uma vez, em 1,6 s. | boolean | false |
hatO chapeu de festa: `party` (Carnaval), `straw` (Sao Joao), `santa` (Natal) ou `newyear` (Reveillon). | "newyear""party""santa""season""straw" | sem padrão |
labelO nome do desenho para o leitor de tela. | string | sem padrão |
loopSem `loop`, o movimento que repete toca o que cabe em 5 s e para no quadro de repouso, dentro da WCAG 2.2.2. | boolean | false |
motionO 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 |
poseO 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" |
sizeA 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.mdO 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.
| Prop | Tipo | Padrão |
|---|---|---|
alignOnde ele espia, ao longo da borda de cima de `children`: `start` e `end` a 12% da ponta, `center` no meio. | "center""end""start" | "end" |
animatedAo 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. | boolean | true |
classNamesClasse 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 |
followPointerAs pupilas seguem o ponteiro na janela, cada olho no seu passo, ate 5 e 6,5 unidades do desenho. | boolean | false |
happyOs olhos fecham em arco e ele sorri: para quando o ponteiro chega, ou quando a conversa que ele abre esta aberta. | boolean | false |
hatO chapeu de festa, com os mesmos valores do `Bacalhau`, `season` incluido. | "newyear""party""santa""season""straw" | sem padrão |
labelO nome do desenho para o leitor de tela. | string | sem padrão |
loopO flutuar e o piscar continuam depois dos 5 s. | boolean | false |
overlapCom `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. | boolean | false |
shyTimido: quando o ponteiro chega a menos de 90px dos olhos ele desce, e volta 1,6 s depois com a entrada cautelosa. | boolean | false |
sizeA largura: `sm` 90px, `md` 144px, o padrao, e `lg` 198px. | MascotPeekSize | "md" |
visibleSe 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. | boolean | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.