EnglishGitHub

Documentação

Conteúdo e painel

Tudo o que aparece no site é conteúdo, guardado no Convex e editado no painel (/admin). O código do projeto só muda quando você quer outro visual ou outro comportamento.

Duas ideias organizam o conteúdo: páginas feitas de blocos e coleções de itens que se repetem.

Páginas e blocos

Uma página tem um endereço (/, /sobre, /servicos), um título, o SEO (título, descrição e imagem de compartilhamento, por idioma) e uma lista ordenada de blocos. Cada bloco é uma seção: abertura, texto, números, serviços, depoimentos, perguntas frequentes, chamada para ação, contato e assim por diante.

Em Páginas, no painel, você:

  • cria uma página nova e escolhe os blocos;
  • reordena os blocos, liga e desliga (o bloco oculto fica guardado, sem aparecer no site);
  • edita os campos de cada bloco num formulário, com prévia ao vivo do tema ao lado, em largura de celular ou de desktop;
  • salva como rascunho ou publica.

As páginas da home, do sobre e do contato não são especiais: vêm montadas pela receita do tema na criação do site e se editam como qualquer outra.

Catálogo de blocos

O catálogo de blocos lista todos os blocos, com para que serve cada um, os campos, as variações e o plugin de que dependem. Ele é gerado do código do núcleo, então está sempre em dia.

Cada bloco que lista itens aponta para uma coleção com filtro, ordem e quantidade, em vez de copiar os itens. Alguns blocos têm variações com nome (por exemplo, cases em grade ou em lista); o painel mostra só as variações do tema em uso.

Um bloco novo que o Rubrica lançar aparece em todos os temas com a versão padrão do núcleo, até o tema desenhar a dele. Precisa de um bloco que não existe? Veja Criar um bloco.

Coleções

Coleções são listas de itens com campos fixos, cada uma com a sua tela no painel:

Coleção Tipo de site O que guarda
Posts os dois Artigos do blog, com capa, tags, SEO e tradução
Projetos e cases os dois Projetos, com a página de case
Serviços os dois O que você ou a empresa oferece
Depoimentos os dois Depoimentos, publicados ou pendentes de aprovação
FAQ os dois Perguntas e respostas
Currículo e dia a dia pessoal Experiência, formação, competências, rotina
Planos empresa Nome, preço, período, itens, destaque e botão
Equipe empresa Foto, nome, cargo, bio curta e redes

Na linha de empresa também há os dados da empresa (razão social, CNPJ, endereço, horário, telefone, WhatsApp, mapa), um registro único que gera o rodapé e o dado estruturado Organization/LocalBusiness para o Google.

Projetos e cases

Cada projeto tem uma página de case. Desde a 2.3.0 o corpo dela é feito de blocos, os mesmos das páginas, e não mais de seções fixas de título e texto. Isso permite contar o case do jeito que ele pede: texto, imagens, vídeo, antes e depois, paleta, tipografia.

No editor do projeto (Projetos, no painel), o que fica em volta do corpo continua em campos: título, resumo, capa, cliente, ano, papel, categoria, links e números de destaque. O Corpo do case é o editor de blocos, igual ao de uma página, e há uma prévia do case como o visitante o vê, no tema em uso. O painel só oferece os blocos que valem num case: hero, contato e cases ficam de fora, porque o título da página é do template.

Blocos de marca e mídia

Além dos blocos de texto, lista e números, o case aceita blocos pensados para trabalhos visuais (todos valem também nas páginas):

Bloco Para quê
Antes e depois Duas imagens comparadas: o logo antigo e a marca nova, a tela de antes e a de depois. Comparador deslizante (sem JavaScript, as duas ficam lado a lado) ou lado a lado
Paleta de cores As cores de uma marca, com nome, código, papel, uso e o contraste de cada uma
Tipografia As fontes de uma marca, cada uma escrita na própria fonte (do Google Fonts) ou numa imagem, para fontes de fora
Variações de marca As versões de um logo (principal, horizontal, só o símbolo, sobre fundo escuro), cada uma sobre a cor de fundo que quiser
Imagens Telas, mockups e aplicações da marca, em grade, mosaico ou carrossel, cada imagem com legenda
Vídeo Um vídeo do YouTube ou do Vimeo, com capítulos opcionais: pontos do vídeo com nome (1:05, 1:02:30), e cada um abre o vídeo naquele ponto

Veja os campos de cada um no catálogo de blocos.

Não há envio de vídeo para o site: o vídeo mora no YouTube ou no Vimeo e entra por link, o que mantém o site leve e rápido. Para uma animação curta (uma animação de logo, uma transição de tela), exporte um GIF, suba na biblioteca de imagens e use-o no bloco Imagens como qualquer outra imagem.

Case com a cara do cliente

Um case pode vestir as cores e a fonte de título do cliente só dentro dele. O cabeçalho e o rodapé do site continuam com o seu tema. No editor do projeto, em Cara do cliente:

  1. ligue a opção;
  2. escolha o fundo, o texto e o destaque do modo claro (e, se quiser, os do escuro; sem eles, vale o mesmo do claro);
  3. escolha, se quiser, uma fonte de título do Google Fonts (o nome da família, como Fraunces). Ela é baixada no build.

O painel mostra o contraste de cada cor enquanto você escolhe, e o painel e o MCP recusam a marca se o texto sobre o fundo tiver menos de 4,5:1 ou o destaque sobre o fundo, menos de 3:1, em qualquer dos dois modos. É a regra que garante que o texto continue legível com qualquer marca. Com a opção desligada, as cores ficam guardadas sem aplicar (só o formato é conferido), para você ajustar com calma.

Cases criados antes da 2.3.0

Os campos antigos (content e sections) continuam sendo lidos: o site mostra esses cases normalmente, com o texto convertido em blocos de texto na hora. Para passar o conteúdo de verdade para blocos, rode a migração do update. Veja Atualizar o Rubrica.

Pelo agente

O MCP monta o corpo do case com as ferramentas block_*, passando project no lugar de page, e grava a cara do cliente no campo brand do projeto (projects_update).

Outras telas do painel

  • Aparência: esquema de cores, modo, fontes e tokens do tema. Veja Temas.
  • Configurações: identidade, endereço, navegação, redes sociais, SEO, ícones, WhatsApp e faixa de aviso.
  • Textos: os textos de interface (menu, "ler mais", formulários, 404), por idioma. Os títulos e botões de cada seção não estão aqui: são campos do bloco.
  • Mídia: biblioteca de imagens.
  • Contatos, Propostas, Contratos, Pagamentos: o lado comercial, quando os plugins estão ligados.
  • Plugins: liga e desliga recursos. Veja abaixo.
  • Privacidade (LGPD): política de privacidade gerada a partir dos dados da empresa e dos plugins ligados, e a exportação ou exclusão dos dados de um titular.
  • Usuários e atividade: só para o root.

WhatsApp e faixa de aviso

Dois recursos valem para o site inteiro, nos dois tipos de site, e ficam em Configurações (com prévia da página inicial, antes de salvar). Os 14 temas mostram os dois sem nenhum ajuste.

WhatsApp

  • Número: em formato internacional, com DDI e DDD (+55 11 91234-5678). O painel aceita espaços, parênteses e traços e guarda só os dígitos.
  • Mensagem inicial (por idioma): já vem escrita quando a conversa abre. Sem tradução num idioma, a conversa abre em branco nele.
  • Botão flutuante: liga um botão no canto de baixo de todas as páginas (menos proposta e checkout), que abre a conversa em outra aba. Não usa JavaScript, respeita quem pede menos movimento e não cobre a troca de tema nem o menu do tema.
  • Texto do botão (por idioma, opcional): aparece ao lado do ícone em telas largas. Vazio, fica só o ícone, com o nome acessível "Conversar comigo no WhatsApp" (ou "Fale conosco no WhatsApp" no site de empresa), que você muda em Textos (whatsapp.float).

Em qualquer botão ou link, use o endereço whatsapp: no lugar de uma URL: ele vira o link do WhatsApp do site com a mensagem inicial do idioma. Para uma mensagem própria, escreva depois dos dois-pontos: whatsapp:Quero o plano Pro. Vale nos botões dos blocos, nos planos, no menu e no link da faixa de aviso. Sem número configurado, o link whatsapp: não aparece (o botão some, em vez de levar a lugar nenhum). Se o WhatsApp não foi configurado aqui, o whatsapp: usa o WhatsApp dos dados da empresa.

Botões para o contato. Nos temas que abrem o contato numa janela (o padrao e o cyberpunk), um botão ou link com o endereço contato: (ou #contato) abre a janela com o formulário de contato, em qualquer página. Assim o bloco de chamada (cta) e o hero podem levar ao contato sem uma seção de contato na página. Nos outros temas, contato: leva ao bloco de contato da home.

No site de empresa, o número também entra nos dados estruturados da organização (contactPoint), para o Google.

Faixa de aviso

Uma linha no topo de todas as páginas (menos proposta e checkout, que são o fluxo de uma pessoa só): agenda aberta, promoção, mudança de horário.

  • Texto (por idioma, até 200 caracteres). Sem texto num idioma, a faixa não aparece nele: não cai no idioma principal.
  • Link opcional, depois do texto (/contato, https://… ou whatsapp:). Sem rótulo num idioma, a faixa aparece sem o link.
  • Estilo: discreto (cores de cartão) ou destaque (cor principal do tema). Os dois passam o contraste AA em todos os esquemas e nos dois modos.
  • Começa em / Termina em (opcionais): AAAA-MM-DD, que vale o dia inteiro em UTC (21h do dia anterior em Brasília), ou data e hora com fuso, 2026-12-01T09:00-03:00.

O período é avaliado na publicação, porque o site é estático: o aviso só entra ou sai do ar no primeiro build depois da data. Para um aviso que precisa sair na hora certa, publique o site nesse momento.

Plugins

Cada recurso opcional é um plugin que o painel liga e desliga: assistente de contato, propostas, modelos de contrato, pagamentos, blog, projetos, currículo, dia a dia, depoimentos, envio de depoimentos, tradução com IA, currículo por vaga com IA, analytics (Umami), registro de atividades e biblioteca de mídia. No tipo empresa entram também preços e equipe. Desligado, o recurso some do site e do menu do painel. Os plugins que precisam de uma chave de serviço externo estão em Integrações. O que cada um faz, em qual tipo de site e como começa está em Plugins.

Papéis

Cada usuário do painel tem um papel, e o painel mostra só o que o papel pode mexer.

Papel Para quem O que faz
root A agência ou quem mantém o site Tudo, inclusive usuários, registro de atividades, restaurar da lixeira e a configuração técnica (tipo do site, endereço, idiomas, tema)
admin O dono da empresa ou do portfólio Todo o conteúdo, os contatos, as propostas e as configurações, sem gerenciar a agência
content-editor Quem cuida do site no dia a dia Páginas, coleções, textos e mídia
blog-editor Quem escreve Posts do blog e mídia
comercial Atendimento e vendas Propostas, contratos, checkouts, contatos e planos
proposal-editor Quem só faz propostas Somente propostas

O primeiro usuário, criado no setup, é o root. Crie os outros em Usuários. A regra vale no backend, não só na tela: quem não tem o papel não consegue a operação nem por outra via.

Na tela Usuários, o root também:

  • Reinicia a senha de alguém, sem e-mail. O painel gera uma senha temporária e mostra uma vez só, para você passar à pessoa. Ela sai de todas as sessões abertas e cria uma senha nova no próximo acesso. A sua própria senha você troca em Minha conta. Se ninguém consegue entrar, use npx create-rubrica senha no terminal.
  • Suspende o acesso: a pessoa sai do painel na hora, e o papel e o histórico ficam guardados. Reativar devolve o mesmo papel.
  • Exclui a conta de vez: apaga o login e o papel. Para só tirar o acesso, prefira suspender.

Quem está com senha temporária não consegue fazer nada antes de trocá-la, nem pelo painel nem pelo MCP.

Publicar uma mudança

Salvar no painel grava no Convex na hora, e o site estático só muda no próximo build. O botão Publicar do painel dispara o build na hospedagem (o deploy hook). Veja Publicar o site.

Editar no GitHub