# O Bacalhau

O Bacalhau é o mascote da RivoCode: um bacalhau chibi cor de limão, de olhos
grandes do mesmo tamanho, dois brilhos em cada um e bochechas rosadas. Este guia
é a biblioteca dele: as poses, o jeito de espiar, as fotos de perfil, as
animações, o calendário de chapéus, onde ele aparece, a voz dele, as regras, a
marca e o roteiro para criar outros mascotes no mesmo padrão. A folha viva do
personagem está no fim da página.

Ele mora em `@rivocode/ui/mascot`, sem dependência nenhuma a instalar, e em
`@rivocode/ui-native/mascot`, atrás do `react-native-svg`. A API é a mesma nos
dois. A referência das props fica na página do
[`Bacalhau`](/componentes/bacalhau).

```tsx
import { Bacalhau, BacalhauPeek } from '@rivocode/ui/mascot'

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

## Poses

Quarenta e sete poses, um só bacalhau. Mesmo corpo e mesmo rosto, todas na
mesma caixa, então trocam sem pular. Mudam os braços, o rosto e um adereço;
o corpo, as cores e a proporção ficam. As que têm partes vivas se mexem
sozinhas: a mão acena, os brilhos piscam, os "z" sobem, o balão de pensamento
aparece em bolinhas, as mãos digitam, a lupa procura, o foguete decola, o café
solta vapor, o coração bate, as engrenagens giram, e os pés andam com a
barbatana e o rabinho vindo um instante depois.

A lista inteira, com o que cada pose faz e onde ela cabe, está na página do
[`Bacalhau`](/componentes/bacalhau). As mais usadas:

| Pose | Quando |
|---|---|
| `standing` | O padrão: ele só precisa estar ali |
| `waving` | Boas-vindas e despedida |
| `celebrating` | Deu certo: mensagem enviada, projeto no ar |
| `thinking` | Enquanto ele "digita" |
| `pointing` | Chamar atenção para um campo ao lado |
| `coding` | Enviando, carregando |
| `sad` | Erro no envio, página 404 |
| `shrug` | Busca sem resultado |
| `sleeping` | Fora do horário |
| `walkingAway` | Seguindo para outro canal |

## Espiando

O jeito de sempre dele: por cima de uma borda, só a cabeça e as mãos. É o
`BacalhauPeek`. Ao montar ele sobe com cautela até os olhos passarem da beirada,
olha para um lado e para o outro, e só então aparece inteiro e agarra a borda;
depois flutua e pisca. `happy` fecha os olhos em arco, para o ponteiro que chega
perto ou a conversa aberta. É ele com os chapéus de cada época.

Com o painel em `children`, a cabeça fica atrás da borda e as mãos na frente.
`visible` o tira de cena e o traz de volta com a mesma entrada; `followPointer`
faz os olhos seguirem o ponteiro, e `shy` o faz descer quando o ponteiro chega
perto e voltar logo depois.

## Perfil

O Bacalhau no perfil das conversas: a foto do WhatsApp e da conta que envia os
e-mails, em 1080×1080, feita para o recorte redondo. Nas festas, troque pela do
chapéu da época, no mesmo calendário do site. No Instagram a foto continua sendo
o logo de ondas: a marca assina a empresa, e o Bacalhau dá o tom das conversas.

| Foto | Quando |
|---|---|
| Espiando | O ano todo |
| Espiando feliz | A variação mais leve, de olhos fechados e sorrindo |
| Acenando | De corpo inteiro, dando oi |
| Fundo claro | Se a escura pesar no tema claro do WhatsApp |
| Carnaval, São João, Natal, Réveillon | Nas datas do calendário abaixo |

Dentro de um produto, o perfil é um `Bacalhau` de `size="xs"` num círculo, que
troca de `pose` conforme a conversa e dá um pulinho (`motion="hop"`) a cada
troca. No chat do site institucional, momento a momento:

| Momento | Pose | Sob o nome |
|---|---|---|
| Abriu o chat | `waving` | mascote da RivoCode |
| Preparando a pergunta | `thinking` | digitando… |
| Esperando a resposta | `standing` | mascote da RivoCode |
| Falta algo, ou parado 30 s | `pointing` | mascote da RivoCode |
| Enviando o e-mail | `coding` | enviando… |
| Deu certo | `celebrating`, com confete | |
| Seguiu para o WhatsApp | `walkingAway` | vai embora andando |
| Falhou | `sad` | tenta de novo ou WhatsApp |

## Animações

O que ele faz, e não só como está. O corpo inteiro se mexe com `motion`; as
partes de cada pose se mexem sozinhas.

| Animação | Como se pede | O que faz | Onde |
|---|---|---|---|
| Acenar | `pose="waving"` | A mão balança do pulso algumas vezes | Abrir o chat, despedida |
| Comemorar com confete | `motion="bounce" confetti` | Quica de alegria e solta confete nas cores da marca | Mensagem enviada |
| Mortal | `motion="flip"` | Sobe girando e cai no lugar | O easter egg |
| Pulinho | `motion="hop"` | Um salto curto | Cada troca de pose no perfil |
| Quicar | `motion="bounce"` | Quica no lugar, de alegria | Comemorando |
| Respirar | `motion="breathe"` | Infla e desinfla devagar: parece vivo parado | O perfil esperando, os Termos |
| Nadar | `motion="swim"` | Balança de um lado para o outro, como na água | O carregando |
| Tremer | `motion="shake"` | Uma tremidinha de susto ou de tristeza, duas vezes | A 404, a falha no envio |
| Espiar e se esconder | `BacalhauPeek` | Sobe com cautela, olha para os lados e agarra a borda | Em cima de um painel |
| Andar de frente | `pose="walking"` | O corpo desce no passo, os pés se alternam, os braços balançam | A caminho |
| Andar de costas | `pose="walkingAway"` | O mesmo passo, de trás, com o rabinho balançando | Saindo |
| Piscar | `BacalhauPeek` | Pisca de vez em quando, sozinho | Todo bacalhau que espia |
| Seguir com os olhos | `followPointer` | As pupilas vão atrás do ponteiro, cada olho no seu passo | Em cima do painel da página |
| Fugir do ponteiro | `shy` | Desce quando o ponteiro chega perto e volta 1,6 s depois | Em cima do painel da página |

**Nada fica em laço sem pedir.** O que repete toca o que cabe em 5 s e para no
repouso, como pede a WCAG 2.2.2; `loop` mantém rodando, só para a tela de
carregamento. **Quem pede menos movimento vê tudo parado**, sem o confete, e a
peça faz isso sozinha.

## Calendário

Ele sabe que dia é hoje. Com `hat="season"`, o chapéu é escolhido no aparelho
de quem vê, pela data, e ninguém precisa publicar nada em cada festa:

| Chapéu | `hat` | O que muda | Quando |
|---|---|---|---|
| Carnaval | `party` | Chapéu listrado, confete e serpentina | Do sábado à quarta-feira de cinzas. A data é calculada pela Páscoa, todo ano |
| São João | `straw` | Chapéu de palha trançada com fita e um varal de bandeirinhas | O mês de junho inteiro. Somos de João Pessoa |
| Natal | `santa` | Gorro de pelúcia com a ponta caída e neve | De 1 a 25 de dezembro |
| Réveillon | `newyear` | Chapéu dourado com estrelas e fogos | De 26 de dezembro a 1º de janeiro |

Fora dessas datas, sem chapéu. `seasonHat(date)` faz a mesma conta para quem
quer decidir por conta própria (o site institucional testa com `?festa=carnaval`,
`sao-joao`, `natal` ou `reveillon` no endereço).

## No site

Onde ele aparece hoje.

**Neste site, o `ds.rivocode.com.br`:** espiando por cima da vitrine da página
inicial, com o chapéu da época; dando de ombros na busca que não achou nada;
tristinho e tremendo na página que não existe ("Esta página foi pescada");
e nadando quando uma página demora mais de meio segundo para chegar. Nunca dois
ao mesmo tempo: se a busca vazia abre por cima da página inicial, o que espia
sai e volta quando ela fecha.

**No `rivocode.com.br`:**

- **Hero**: espia por cima do painel do sistema. Some se o ponteiro chega perto;
  cinco cliques nele soltam o easter egg.
- **Canto da tela**: depois da hero, espia do canto, e o clique abre o chat.
  Depois de 25 s lendo, um balão "Bora conversar?" surge junto da cabeça, uma
  vez.
- **No celular**: menor, e mergulha enquanto a página rola; volta quando ela
  para, para nunca cobrir o texto.
- **Chat**: faz as perguntas, reage a cada resposta e comemora com confete.
- **Página 404**: tristinho, tremendo: "Esta página foi pescada."
- **Termos**: de óculos, lendo e respirando, ao lado do título.
- **Aba do navegador e celular**: o favicon e o ícone de app são ele espiando.
- **Link compartilhado**: a imagem do WhatsApp e das redes tem ele acenando.
- **E-mail de "recebemos"**: comemorando no topo.
- **Página de status**: respirando quando está tudo no ar, andando quando algo
  está em configuração, tremendo se algo falhou.
- **Easter egg**: o código Konami, ou cinco cliques na hero, e ele dá um mortal
  com confete.

## Frases

Frases na voz dele: curtas, honestas e com bom humor. Cada situação já vem com a
pose que combina. O desenho não fala: a frase vai no texto ao lado, que é o que
o leitor de tela lê.

| Situação | Pose | Frases |
|---|---|---|
| Boas-vindas | `waving` | Oi! Eu sou o Bacalhau, o mascote da RivoCode. Vou fazer umas perguntas rápidas para o time já chegar sabendo do que se trata. O que você quer resolver? · Oi de novo! Quer continuar de onde parou? · Bora conversar? Leva menos de um minuto. |
| Pensando, digitando | `thinking` | Deixa eu pensar aqui… · Hmm, boa pergunta. · Anotado. Só mais uma coisinha: |
| Deu certo | `celebrating` | Pronto! Sua mensagem chegou. A resposta vai para o seu e-mail. · Fisgado! O time já recebeu e responde em breve. · Mandou bem. Agora é com a gente. |
| Deu errado | `sad` | Não consegui enviar agora. Suas respostas continuam aqui: tente de novo ou siga pelo WhatsApp. · Ih, a linha embolou. Tenta de novo? · Algo não saiu como devia. O que você escreveu está guardado. |
| Página não encontrada | `sad` | Esta página foi pescada. · O Bacalhau procurou e não achou nada aqui. · Esse endereço nadou para longe. |
| Campo faltando | `pointing` | Preciso de um nome para te chamar. · Preciso de um e-mail para o time te responder. · Confira o e-mail: falta o @ ou o domínio. |
| Carregando, enviando | `coding` | Enviando… · Preparando tudo… · Um instante, estou nadando até lá. |
| Descansando | `sleeping` | O time está descansando agora. Deixa sua mensagem que a gente responde no próximo dia útil. · Chegou tarde, mas chegou. Respondemos no próximo dia útil. |
| Despedida | `waving` | Abri o WhatsApp com o resumo da conversa. É só enviar por lá. · Até já! Qualquer coisa, estou aqui no canto. |
| Novidade | `surprised` | Opa, tem coisa nova por aqui. · Urgente, hein! O time vai te dizer o que cabe nesse prazo. |
| Atendimento | `support` | Quem responde é quem constrói. · Fala com a gente: a resposta vem de quem escreveu o código. |
| Entrega | `launching` | Mais uma entrega no ar! Próxima em 15 dias. · Subiu! Pode testar que está quentinho. |
| Diagnóstico | `searching` | Vamos procurar onde a tecnologia devolve tempo para o seu time. · Primeiro a gente entende, depois a gente constrói. |
| Datas | `winking` | Arraiá do Bacalhau! Feliz São João. · Boas festas, do Bacalhau e do time RivoCode. · Bora pular Carnaval? |

## Ideias

O que já foi feito, e o que ainda dá para fazer.

| Status | Ideia |
|---|---|
| feito | Chat com perguntas e reações: uma pergunta por vez, reação a cada resposta, confete quando envia |
| feito | Um bacalhau por vez: hero, canto e easter egg revezam o mesmo palco |
| feito | Página 404, "Esta página foi pescada", tremendo de tristeza |
| feito | Favicon, ícone de app e imagem de compartilhamento |
| feito | Lembrete gentil e o balão "Bora conversar?", uma vez por visita |
| feito | Educado no celular: mergulha enquanto a página rola |
| feito | Easter egg: Konami ou cinco cliques, mortal com confete |
| feito | Datas da casa: Carnaval, São João, Natal e Réveillon, sozinho |
| feito | Termos com ele lendo, de óculos |
| feito | Animações vivas: cada pose mexe as próprias partes |
| feito | Acabamento: sobrancelhas que seguem a emoção, volume, sombra no chão e postura |
| feito | Andar de frente e de costas, com peso, alternância e continuidade |
| feito | Figurinhas de WhatsApp: 54 em WebP 512 px, em dois pacotes de até 30 |
| feito | Adesivos, foto de perfil, versão divertida do logo, post "dica da semana", capa de proposta, assinatura de e-mail, tela de carregamento e e-mail de aniversário de projeto |
| feito | Página de status: respira, anda a caminho ou treme |
| feito | Camiseta: frente com ele espiando de um bolso, costas com ele indo embora nas ondas |
| feito | Na biblioteca de componentes, nos dois pacotes, e neste site |
| pronto para ligar | E-mail automático de "recebemos", no máximo uma resposta por endereço por dia |
| fora das regras | Ele nadando no fundo da página: quebraria "um bacalhau por vez" e "depois da hero, só no canto" |

## Regras

O que faz dele sempre o mesmo.

- **Um bacalhau por vez na tela.** Depois da hero, ele só aparece no canto, como
  o chat.
- **Sempre chibi**: cabeça grande, olhos grandes do mesmo tamanho, dois brilhos
  em cada um, bochechas rosadas.
- **Mesmo corpo e mesmo rosto em toda pose.** Pose nova é o mesmo bacalhau
  fazendo outra coisa.
- **Ele reage ao que aconteceu de verdade.** Confete só para o que deu certo.
- **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.**
- **Toda animação tem alternativa**: quem pede menos movimento vê a pose parada.
- **O logo da RivoCode continua sendo as ondas.** Ele é o rosto da marca, não o
  logo.
- **Não usar**: peixe de lado em ASCII ou pixel, deitado ou boiando, com plugue
  ou cabo, um olho maior que o outro.

Na tela de um produto de cliente, o desenho de erro e de vazio é a
[`Illustration`](/componentes/illustration), que troca de cor com o tema dele.
O Bacalhau é da RivoCode.

## Marca

| Cor | Valor | Onde |
|---|---|---|
| Limão | `#d4f34a` | o corpo |
| Verde | `#b3d22e` | barbatanas, pés, pintinhas |
| Tinta | `#14170a` | contorno e pupilas |
| Bochecha | `#ff8fa3` | a 60% de opacidade |
| Branco | `#ffffff` | olhos e brilhos |
| Água | `#8fd3ff` | lágrima, janela do foguete |
| Chama | `#ffb44a` | foguete |
| Vermelho | `#d6453d` | gorro, fita do chapéu |
| Palha | `#e9c46a` | chapéu de São João |

As cores são fixas e não mudam com o tema. No escuro, a silhueta é o limão
contra o fundo; no claro, o contorno de tinta. Na biblioteca elas moram em
`src/tokens/mascot.ts`, e chegam ao nativo por `tokens.mascot`.

**As peças fora da tela** moram na página [Marca](/marca), em
`ds.rivocode.com.br/marca/`, desenhadas do mesmo código: o SVG e o PNG
transparente de 512 px de cada pose e de cada espiada, a versão divertida do
logo (ele espiando por cima das ondas), o favicon, as figurinhas de WhatsApp em
WebP com o ícone do pacote e os adesivos em PNG com contorno branco para a
gráfica. O site institucional usa esses arquivos pelo endereço. A foto de
perfil de 1080 px, o post "dica da semana", a camiseta e a capa de proposta
continuam em `rivocode.com.br/bacalhau/`. Nenhum desses arquivos vai no pacote:
o desenho da biblioteca é o mesmo, em código, e qualquer pose sai em SVG pelo
"Copiar SVG" da folha abaixo.

## Skill

Para criar o mascote de outra marca no mesmo padrão, a skill da biblioteca tem
o roteiro inteiro, em `reference/mascote.md`: briefing do personagem,
exploração lado a lado, o desenho, a folha de expressões e de poses, a
animação, a produção técnica, o guia do personagem e a verificação antes de
entregar. Ela entra junto com a [skill](/skill). Para montar uma skill própria,
só de mascotes, cole este pedido no Claude Code:

```text
Crie uma skill do Claude Code chamada "criador-de-mascotes", em
.claude/skills/criador-de-mascotes/SKILL.md (com arquivos de referência em
references/ quando ajudar), especializada em criar mascotes de marca do zero
até um personagem completo, consistente e pronto para uso. Ela deve servir para
qualquer marca e ser acionada quando alguém pedir para criar, redesenhar,
expandir ou padronizar um mascote, personagem ou avatar de marca.

A skill deve conduzir o trabalho nestas etapas, sempre nesta ordem:

1. Briefing do personagem (antes de qualquer desenho): marca, público, tom,
   onde o mascote vai viver, cores e símbolo da marca, e o que ele NÃO pode ser.
   Escolher o que ele é a partir da marca e registrar o porquê. Escrever a ficha:
   nome, uma frase de personalidade, 3 traços, a voz, o que ama e o que evita, e
   o papel dele na marca. Pedir uma referência visual; sem ela, não chutar.
2. Exploração visual lado a lado: de 3 a 5 direções numa página de comparação,
   cada uma também em 48px e 16px. Registrar o aprovado e o recusado, com o
   motivo, e nunca reapresentar o recusado.
3. Desenho do personagem aprovado: silhueta reconhecível pela sombra; rosto como
   sistema de peças trocáveis; paleta curta (até 6 cores base); contorno de
   espessura única; contraste sobre fundo claro e escuro; teste em 16, 48, 128 e
   512px e em uma cor só.
4. Folha de expressões e de poses: as expressões, a biblioteca de poses de
   partida e a pose "espiando por cima de uma borda". Toda pose é o mesmo
   personagem fazendo outra coisa, na mesma caixa (viewBox). Época e contexto
   como acessório, nunca como personagem novo.
5. Animação: antecipação, comprimir e esticar, continuidade, tempo e
   espaçamento; partes em camadas; o conjunto mínimo (piscar, respirar, acenar,
   pulinho, comemorar com confete, tremer, pensar, dormir); toda animação com
   alternativa para prefers-reduced-motion.
6. Produção técnica: SVG à mão em componentes reutilizáveis, sem imagem
   rasterizada como fonte; exportar SVG e PNG transparente (512 e 1024px),
   favicon, ícone de app, foto de perfil e figurinhas WebP 512x512; arquivos
   nomeados pela pose; a lista de poses num lugar só no código.
7. Guia do personagem: uma página "Biblioteca do mascote" gerada do código, com
   a ficha, as poses, as animações, os acessórios e datas, as frases na voz dele,
   as regras, as cores, os arquivos e as ideias com status. O mascote não
   substitui o logo, não aparece distorcido nem recolorido, e nunca "fala"
   depoimento, número ou promessa que a marca não possa cumprir.
8. Verificação antes de entregar: cada pose ampliada e no tamanho real, todas
   lado a lado, contraste no claro e no escuro, animações com e sem movimento
   reduzido, arquivos com fundo transparente.

Módulo opcional, o mascote numa interface: um por vez na tela; ele reage ao que
acontece de verdade; balão de fala curto; aparece e se esconde sem cobrir
conteúdo, inclusive no celular. O desenho é decorativo (aria-hidden) e o texto
ao lado é o que é lido; alvos de toque de 44px; foco visível.

A skill deve terminar cada entrega dizendo o que foi feito, o que foi
verificado e o que depende de decisão do dono.
```
