Skip to contents

Objetivo: transformar o fork do pacote britânico shinyGovstyle em uma implementação nativa do Design System do GovBR (https://www.gov.br/ds/home) para Shiny, completa o suficiente para publicação no CRAN.

Situação inicial (diagnóstico, set/2026)

  • O pacote era o shinyGovstyle (GOV.UK Frontend) com classes renomeadas de govuk- para govbr-. Não usava os assets reais do GovBR DS.
  • attachDependency.R apontava para govbr-frontend-test.css (apenas classes de fonte), e o govbr-frontend-5.7.1.min.css (na verdade GOV.UK 5.7.1 renomeado) não era referenciado por código R algum.
  • CI de deploy do app de exemplo apontava para o repositório upstream.
  • Nomenclatura inconsistente (mistura button_Input/checkbox_input).

Fase 1 — Fundação (concluída nesta iteração)

Fase 2 — Componentes essenciais (família br_*)

Nova família de funções com prefixo br_, marcado snake_case, usando as classes reais (br-header, br-input, br-button, …) e os bindings nativos do Shiny sempre que possível (radio/checkbox por name, texto e data por id, botão via action-button).

Concluídos nesta iteração:

Pendentes (próximas iterações):

Fase 3 — Limpeza e deprecação

Fase 4 — Publicação no CRAN

Convenções da nova família br_*

  • Arquivo por função em R/br_<componente>.R, teste espelhado em tests/testthat/test-br_<componente>.R.
  • Sempre terminar com use_govbr() implícito: cada componente anexa as dependências via htmltools::attachDependencies() (o usuário também pode chamar use_govbr() explicitamente no topo do UI).
  • Shiny bindings nativos: radios/checkbox-group usam name = inputId; inputs de texto/data usam id = inputId; botões usam class = "action-button".
  • Referência de markup: data-raw/govbr-templates/ e https://www.gov.br/ds/components