A v2: o Rubrica deixa de ser um template copiado para o projeto e vira um núcleo em pacote, com temas e duas linhas de site (pessoal e empresa). Atualizar passa a ser subir a versão de um pacote.
Vindo da 1.x: não é uma atualização, é uma migração. Rode npx create-rubrica@latest migrar num projeto na 1.13.1, com o git limpo: ele cria a branch rubrica-v2, troca o código, converte os dados e lista o que você personalizou. Nada é gravado no Convex: o import vai para um banco de desenvolvimento novo, e a produção só com o seu "ok". Guia: Migrar da v1. A v1 recebe correções de bug e de segurança por 6 meses na branch v1, onde também fica a documentação dela.
Segurança
Três falhas da v1 estão corrigidas na v2. A v1 não recebe correção para elas: se você tem um site v1 com propostas, a solução é migrar para a v2.
- Proposta com senha não vaza mais o conteúdo pela API. Na v1, quem chamava a consulta pública da proposta recebia o conteúdo mesmo sem digitar a senha: só a página escondia. Agora, sem sessão válida, a API devolve só o estado ("bloqueada"), sem o conteúdo.
- O limite de senha errada agora bloqueia de verdade. A tentativa errada lançava erro, o que desfazia a contagem de tentativas, e o limite nunca era atingido. Agora a tentativa é registrada e, passado o limite, a proposta responde
TOO_MANY_ATTEMPTS.
- Um só modelo de contrato padrão. A v1 tinha dois modelos padrão (um no código e um no banco), e a proposta podia usar um diferente do que o painel mostrava. Na v2 o padrão é um só, o do banco (marcado como padrão); o texto que vem no código serve apenas para criá-lo quando ainda não existe nenhum.
O que mudou na arquitetura
- Núcleo em pacote.
@rubrica/core traz o site (Astro), o painel (React), o backend (Convex) e o MCP. O seu projeto guarda só configuração, blocos próprios e componentes ejetados. O convex/ do projeto vira arquivos de uma linha que reexportam o backend do núcleo.
- Site estático em Astro. Acabaram a pré-renderização improvisada e a SPA: as páginas saem em HTML, com quase nenhum JavaScript (só as partes interativas viram ilhas). Imagens e fontes passam pelo tratamento do próprio Astro, as fontes são servidas pelo próprio site, e as do texto e dos títulos são pré-carregadas.
- Páginas com blocos. Cada página é uma lista de blocos tipados, com prévia ao vivo no painel. São 21 blocos de catálogo (15 comuns, 1 de pessoal e 5 de empresa), com o catálogo gerado do código em Blocos. Entre eles, quatro novos: vídeo (YouTube ou Vimeo; a miniatura carrega leve e o player só entra depois do clique), incorporação (agenda, formulário, mapa ou player, só de provedores permitidos; a CSP gerada já inclui esses provedores), linha do tempo e comparativo de planos. Dá para criar páginas novas pelo painel. O contrato de blocos está na 1.2: a definição de um bloco pode trazer
validate (regras entre campos), sample (exemplo para a vitrine), enhances (ilha que melhora o bloco) e guidance (orientação de uso).
- Duas linhas de site.
pessoal (o portfólio de sempre) e empresa (quem somos, serviços, preços, equipe, cases, contato). Na empresa entram a coleção de planos, a equipe e os dados da empresa (que geram o dado estruturado Organization/LocalBusiness). O escopo é explícito: a linha empresa é para quem vende serviço e recebe pedidos de orçamento, e não é uma loja (sem catálogo de produtos, carrinho nem estoque). As receitas de páginas da empresa usam a linha do tempo e o comparativo de planos. Veja Site de empresa.
- 14 temas, 15 esquemas de cor. Os 13 layouts da v1 viram temas (mesmos nomes), mais o
padrao. Cada tema é um pacote @rubrica/theme-<nome>. Qualquer esquema funciona em qualquer tema, e cada tema ou site pode ter uma textura opcional por cima da página (grão, papel ou scanlines). Todos passam pela mesma bateria de testes (testar-tema: axe, h1 único, <head> completo, limite de JavaScript, Lighthouse).
- Vários idiomas. A lista de idiomas é configurável e o principal é à sua escolha (sem prefixo na URL). Conteúdo sem tradução só não existe naquele idioma: nada de página vazia ou erro 404 interno.
- Papéis de agência e cliente.
root é a agência, admin o dono do site, e há o novo papel comercial (propostas, contratos, checkouts, contatos e planos).
- Usuários. O
root reinicia a senha de alguém pelo painel, sem e-mail: sai uma senha temporária, mostrada uma só vez, as sessões da pessoa caem e a troca é obrigatória no próximo acesso. Também dá para suspender e reativar (o papel fica guardado). O backend cobra a troca da senha temporária: enquanto ela não for trocada, nem o painel nem o MCP nem a API funcionam para aquela conta.
- Propostas, aceite e pagamento. Os plugins ligados geram páginas públicas: a proposta (com senha, contrato, aceite com assinatura opcional e PDF), o aceite, o checkout (PIX, boleto ou cartão, pelo Asaas) e o pagamento concluído. Cada rota vira uma página estática por idioma, e o projeto gera as reescritas para Vercel, Netlify e Cloudflare Pages.
- WhatsApp e faixa de aviso. Nas configurações do site, um botão flutuante de WhatsApp opcional e uma faixa de aviso com datas de início e fim (avaliadas no build). O endereço
whatsapp: funciona em qualquer botão ou link, e o número entra como contactPoint no JSON-LD. O migrar traz o número que a v1 tinha. Veja Conteúdo e painel.
- Contatos e LGPD. Os pedidos vão para o painel e, se você ligar, para o Telegram, o e-mail (Resend) e um webhook assinado (HMAC), com reenvio automático. Há consentimento registrado nos formulários, política de privacidade gerada e exportação ou exclusão dos dados de um titular.
- Agentes. O servidor MCP local (
rubrica mcp) substitui o script Python da skill rubrica: o agente edita páginas, blocos e coleções com o login de um usuário do painel, com prévia antes de gravar. As skills de escrita (rubrica-voz, rubrica-case, rubrica-blog, rubrica-curriculo, rubrica-apresentacao, rubrica-pilar) usam o MCP para gravar. O MCP tem ferramentas de propostas, usa o catálogo real do projeto (inclusive os blocos próprios, lido pelo backend), valida as variações do tema instalado, entrega as receitas do tema (page_recipes) e a orientação de uso de cada bloco.
- Desenvolvimento. O
pnpm dev reflete o que você salva no painel sem reiniciar. Os formulários funcionam fora da Vercel e no computador: o endereço da API sai do Convex (PUBLIC_RUBRICA_API é opcional). A prévia ao vivo do painel funciona no site publicado.
- Documentação. O catálogo de blocos é gerado do código, e há guias para criar um bloco e criar um tema, além de plugins (na 2.0 não há API pública para plugin de terceiros), variáveis de ambiente e site de empresa.
- Hospedagem neutra. A Vercel continua a oficial (o
publicar automatiza só ela), mas o projeto gera vercel.json, public/_redirects e public/_headers da mesma configuração, e o botão Publicar aceita o deploy hook de qualquer hospedagem.
- CLI novo. Comandos
create, setup, config, publicar, senha, update, ejetar, verificar, testar-tema, mcp, migrar e telemetria. Veja Comandos do CLI.
Quebras em relação à v1
- O projeto não é mais uma cópia do template. Não há
src/ do app, templates/, cli/ nem scripts/ no projeto. O update deixa de mesclar arquivos (e de gerar .rubrica-new): sobe pacotes e regenera o convex/.
- Personalizações no código não migram sozinhas. O
migrar as lista, e cada uma vira configuração (tokens do painel), bloco próprio (src/blocks/) ou componente ejetado (ejetar).
- O app deixa de ser uma SPA em Vite. Páginas e rotas são do Astro; o painel fica em
/admin (antes, /login e /admin/* na SPA).
- O plugin
playground saiu. O plugin i18n ("Tradução IA") virou translation: os idiomas são do núcleo, e o plugin só preenche as traduções.
- Textos de seção viraram campos dos blocos (títulos, chamadas e botões); só os textos de interface continuam em "Textos".
- As traduções
ptBR/enUS viram um mapa por idioma. No migrar, o principal é pt-BR e as URLs /en continuam iguais.
- Pré-requisitos: Node 22.23.4 ou mais novo (antes, 20).
- O script Python da skill
rubrica saiu: use o MCP.
- Variáveis de ambiente. Os nomes novos ficam em
docs/v2/variaveis.md; os da v1 (TELEGRAM_ADMIN_CHAT_ID, VERCEL_DEPLOY_HOOK_URL, VITE_UMAMI_*) continuam aceitos.
Pendências conhecidas
Estão em docs/v2/pendencias.md. As principais:
- Painel: imagens no corpo dos textos, prévia ao vivo de posts e cases, tradução de um item inteiro de uma vez e a abertura do PDF do currículo com IA.
- Para a 2.0.x: o
update ainda não regenera vercel.json e public/_headers (correções de cabeçalho, de reescrita e os provedores de incorporação só chegam a projetos novos); as reescritas não foram testadas em hospedagem real; e não há aviso de cookies antes de carregar uma incorporação.