Pular para o conteúdo
Codaqui

Brand book público

Design System

As cores, a tipografia, os componentes e a voz da Codaqui — abertos para voluntários, comunidades parceiras e parceiros de mídia. Transparência também é design.

  • v1.0
  • WCAG 2.2 AA
  • Tokens --cq-*
  • Astro + Tailwind

01

História

A marca carrega a trajetória da associação — de uma conversa em 2020 a centenas de participantes. Dados reais, os mesmos de/sobre/insights.

  1. 2020Origem

    Primeiros Passos

    Conversas e experiências que plantaram a semente do Codaqui.

    Hackathon Campo Mourão inspira a criação do projeto educacional

    • Bate-papo com fundador da Tecnogueto sobre educação periférica
    • Conversa com Zaedy Sayão sobre educação e tecnologia
    • Primeiro emprego remoto do fundador — visão de oportunidades digitais
    • Hackathon 2020 Campo Mourão: presidente como mentor, conheceu a primeira turma 'Kids Academy'
  2. 2021Fundação

    Nascimento do Codaqui

    De 'Kids Academy' à Associação Codaqui — constituição jurídica, primeiros voluntários e primeiras turmas.

    12Participantes
    8Bolsas
    3PCs doados
    1Trilha

    Constituição jurídica da Associação Codaqui

    Primeira trilha de Python concluída com 12 participantes

    • 19/02/2021: Primeiro encontro 'Kids Academy' no Discord do devpr.org
    • Jean, Diana Carvalho e Ivan Coelho Dias — primeiros voluntários
    • Mudança de nome 'Kids Academy' → 'Codaqui'
    • 12 participantes contemplados no primeiro ciclo
    +5 detalhesRecolher
    • 8 bolsas concedidas (R$ 50/mês por 6 meses)
    • 3 computadores doados para participantes
    • 1 trilha completa de Python finalizada
    • Embasamento pedagógico por Lucia Maria Sendim Vieira
    • Constituição jurídica — CNPJ: 44.593.429/0001-05
  3. 2022Crescimento

    Consolidação e Crescimento Digital

    74 encontros realizados entre 2021-2022, novos parceiros e plataformas educacionais.

    74Encontros
    ~30Participantes
    32Discord
    22WhatsApp

    Google Ad Grants e GitHub Campus conquistados

    74 encontros com ~15 participantes recorrentes

    • 74 encontros realizados no período 2021-2022
    • ~15 participantes recorrentes, ~30 participantes no total do período
    • Novos voluntários nas áreas Jurídica e Contábil
    • Google Education (Google Ad Grants) concedido
    +4 detalhesRecolher
    • GitHub Education (GitHub Campus) concedido
    • WorkAdventure — espaço virtual para encontros
    • Expansão das trilhas de ensino
    • Novas comunidades parceiras: Elas no Código e CamposTech
  4. 2023Marco

    Remodelação e Impacto Social

    Doações de computadores, lançamento do projeto Mentoria, financiamento coletivo e presença na DevPR Conf.

    501Discord
    350WhatsApp

    Projeto Mentoria lançado — democratizando acesso a orientação profissional

    Doação de computadores para escola no RJ e pela Cortex Intelligence

    • Doação de computadores para escola no Rio de Janeiro
    • Lançamento do Projeto Mentoria (#QueroMentoria)
    • Financiamento coletivo iniciado via Apoia.se, depois Open Collective
    • Site institucional completamente remodelado
    +6 detalhesRecolher
    • Contratação de apoio organizacional
    • Transparência mensal publicada via Apoia.se
    • Doação de computadores pela Cortex Intelligence
    • DevPR Conf 2023 — Codaqui presente como comunidade apoiadora
    • Apoio ao Campeonato de Skate em Marialva
    • DevPR Starter com Codaqui — foco em novos talentos
  5. 2024Expansão

    Expansão Presencial

    Aulas presenciais no CPM, 95 mentorias realizadas e forte crescimento da comunidade.

    41Encontros
    31Mentorias
    23hHoras
    17Participantes
    501Discord
    14k+Views/mês

    41 encontros presenciais no CPM — primeiro ano com aulas presenciais

    14.000+ visualizações mensais no site

    • 1º Semestre: 25 encontros presenciais no CPM (Centro de Projetos de Maringá)
    • 2º Semestre: 16 encontros presenciais
    • 31 mentorias realizadas totalizando 23 horas
    • 17 participantes mentorados individualmente
    +3 detalhesRecolher
    • Coleta de apoio via Open Collective iniciada
    • DevPR Conf 2024 — prestação de contas publicada
    • +14.000 visualizações mensais no site
  6. 2025Impacto

    Crescimento Contínuo

    Retorno ao formato virtual com 95 mentorias, 66 horas e crescimento expressivo da comunidade.

    95Mentorias
    66hHoras
    45Participantes
    692Discord
    463WhatsApp
    7k+Views/mês

    95 mentorias realizadas — recorde histórico do Codaqui

    692 membros no Discord — maior comunidade até agora

    • 1º Semestre: 15 participantes em aulas virtuais
    • 2º Semestre: 10 participantes em aulas virtuais
    • 95 mentorias realizadas totalizando 66 horas
    • 45 participantes mentorados individualmente
    +2 detalhesRecolher
    • DevPR Conf 2025 — prestação de contas publicada
    • Cloud Native Maringá ingressa como comunidade parceira
  7. 2026Em andamento

    Novos Horizontes

    Novas frentes de ensino com Educação Financeira e Introdução ao Python.

    692Discord
    463WhatsApp
    7k+Views/mês
    2Cursos novos

    Diversificação do ensino: Educação Financeira além de programação

    • Curso de Educação Financeira iniciado
    • Curso de Introdução ao Python iniciado
    • 692 membros no Discord
    • 463 membros no WhatsApp
    +1 detalhesRecolher
    • +7.000 visualizações mensais no site

02

Marca

Três versões oficiais em /img/. A regra de ouro é de contraste: logo escura só sobre fundo claro, logo branca só sobre fundo escuro.

Logo principal da Codaqui

Logo principal

Ameixa #3A2F39 + verde #57B593. Versão preferencial — somente sobre fundos claros.

Monocromática branca da Codaqui

Monocromática branca

Somente sobre fundos escuros (ameixa, fotos escuras, hero). Some sobre fundo claro — nunca usar.

Monocromática ameixa da Codaqui

Monocromática ameixa

Uma cor só (#3A2F39) para contextos sem cor: carimbo, recibo, impressão P&B — sobre fundo claro.

Regra de logo por tema

Vigente em todo o site: o componente BrandLogotroca automaticamente conforme [data-theme]. Experimente alternar o tema no cabeçalho — a logo abaixo acompanha:

Codaqui← viva: segue o tema da página
Logo principal sobre fundo claro (correto)

✓ Fundo claro → logo principal

Logo monocromática branca sobre fundo escuro (correto)

✓ Fundo escuro → monocromática branca

Respiro mínimo

Demonstração de respiro da logo Codaqui

Mantenha ao redor da marca uma área livre igual à altura do "C" do logotipo (a área tracejada). Nenhum texto, logo de parceiro ou elemento gráfico invade esse espaço.

Usos proibidos

  • Não distorcer, esticar ou rotacionar o logotipo
  • Não trocar as cores oficiais (ameixa #3A2F39, verde #57B593, branco)
  • Não usar a logo escura (principal ou mono2) sobre fundo escuro — use a monocromática branca
  • Não usar a monocromática branca sobre fundo claro
  • Não adicionar sombras, contornos, gradientes ou efeitos
  • Não rearranjar o símbolo e o logotipo nem trocar a tipografia

03

Cores

Uma escala verde de marca, uma escala neutra derivada do ameixa (cinzas puros são proibidos) e pares semânticos calibrados para os dois temas. Clique em qualquer swatch para copiar o hex. Os badges indicam o nível WCAG da cor usada como texto sobre fundo claro.

Por que #57B593 não é acionável?

O verde de marca #57B593tem contraste de apenas 2,49:1 sobre branco — reprova WCAG AA para texto e ações. Ele continua sendo a cor da marca (decoração, hero, logo, ilustrações), mas botões, links e textos usam o primary-700#378369(4,55:1 — AA) no tema claro e#89CBB3no tema escuro.

Escala primary (verde Codaqui)

--cq-color-primary-50 … -900 · 500 = cor oficial da marca.

Neutros "plum"

--cq-color-neutral-50 … -900 · derivados do ameixa da marca #3A2F39 — cinzas puros são proibidos.

Cores semânticas

Cada semântica tem um par foreground/background por tema. Os foregrounds escuros foram recalibrados (as versões claras falham AA sobre os fundos escuros) — --cq-color-*muda com [data-theme="dark"].

Info

Tema claro — Info

#2F6FED / #EAF0FD

3,98:1 · AA 18pt+

Tema escuro — Info

#8FB3F9 / #1E2A45

6,78:1 · AA

Sucesso

Tema claro — Sucesso

#2C7A4B / #E8F4EC

4,65:1 · AA

Tema escuro — Sucesso

#5CB87A / #16301F

5,82:1 · AA

Aviso

Tema claro — Aviso

#B45309 / #FBF0E4

4,47:1 · AA 18pt+

Tema escuro — Aviso

#E8963C / #3A2410

6,15:1 · AA

Erro

Tema claro — Erro

#C0392B / #FBEAE8

4,67:1 · AA

Tema escuro — Erro

#E8826F / #3D1B17

5,74:1 · AA

04

Tipografia

System fonts — nenhuma webfont baixada: a página abre instantânea em qualquer conexão. Performance é inclusão. Escala modular 1.25 sobre a base de 16px.

Escala modular 1.25 (12–48px)
  • Democratizar a tecnologia48px · Heróis e números de impacto
  • Democratizar a tecnologia36px · Títulos de página (h1)
  • Democratizar a tecnologia30px · Títulos de seção (h2)
  • Democratizar a tecnologia24px · Subtítulos (h3)
  • Democratizar a tecnologia20px · Destaques e leads
  • Democratizar a tecnologia16px · Corpo de texto (base)
  • Democratizar a tecnologia14px · Texto secundário
  • Democratizar a tecnologia12px · Legendas e metadados

Famílias

Texto e títulos — --cq-font-family-base

system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial

Números de impacto — --cq-font-family-mono

692 membros

Pesos

  • Regular 400Corpo de texto
  • Medium 500Ênfase sutil
  • Bold 700Títulos e labels
  • Black 800Títulos principais

Altura de linha

  • --cq-line-height-tight: 1.2 — títulos
  • --cq-line-height-normal: 1.5 — UI
  • --cq-line-height-loose: 1.7 — leitura longa

05

Componentes

Padrões de UI construídos sobre os tokens — os mesmos usados nas páginas públicas e no app. Demonstrações estáticas; o comportamento real vive nos componentes.

Botões

Primário usa a cor acionável (--cq-action-primary-bg = primary-700 no claro) — nunca o verde de marca #57B593. Altura mínima de 44px (alvo de toque).

Badges

VerificadoNeutroConcluídoEm andamentoEvento

Pills com raio --cq-radius-pill; pares semânticos mudam com o tema.

Alertas

Info — inscrições abertas até sexta-feira.

Sucesso — doação registrada no ledger.

Formulário

Texto de ajuda sempre visível, não só no placeholder.

Formato de e-mail inválido — mensagem ligada ao campo via aria-describedby.

Tabela financeira (padrão do portal de transparência)

DataDescriçãoComunidadeValor
12/09/2026Doação via StripeCodaqui+ R$ 200,00
05/09/2026Reembolso de transporte (DevPR Conf)DevParaná− R$ 85,00
01/09/2026Pagamento a fornecedor (camisetas)Codaqui− R$ 1.240,00

Valores em mono, sinal e cor semântica por direção (crédito/débito) — nunca só cor: o sinal +/− acompanha sempre.

06

Acessibilidade

WCAG 2.2 AA como piso, não como meta. Estas regras valem para toda página e componente do ecossistema Codaqui — inclusive esta página.

  • Contraste AA verificado

    Todo par texto/fundo ≥ 4.5:1 (texto grande ≥ 3:1). A cor acionável é #378369, não o verde de marca.

  • Alvos de toque ≥ 44px

    Botões, links de navegação e campos têm altura mínima de 44px (WCAG 2.5.8).

  • Foco visível sempre

    Anel de 3px em --cq-focus-ring via :focus-visible global (WCAG 2.4.7/2.4.13) — demo abaixo.

  • prefers-reduced-motion respeitado

    Media query global zera animações e transições para quem prefere menos movimento (WCAG 2.3.3).

  • Skip link e landmarks

    Toda página pública tem 'Pular para o conteúdo' e regiões header/main/footer navegáveis.

  • Nada depende só de cor

    Erros têm texto, valores financeiros têm sinal +/−, status têm rótulo.

Demo: foco visível

Pressione Tabpara navegar pelos elementos abaixo. O anel verde de 3px aparece em todos — é o mesmo anel global do site inteiro.

Link de exemplo

Teste também o skip link: recarregue a página e pressione Tab uma vez — "Pular para o conteúdo" aparece no topo.

07

Tom de voz

Português do Brasil primeiro. Linguagem inclusiva e direta: acolhedora sem ser infantil, técnica sem ser arrogante. As palavras abaixo são norma, não sugestão.

DigaEvitePor quê
“participantes”“alunos”Não somos escola: quem chega participa de uma comunidade, não de uma sala de aula.
“programa”“curso”Trilhas, mentoria e encontros formam um programa contínuo — não um produto fechado.
“encontros”“aulas”O formato é horizontal e colaborativo: encontro de pessoas, não transmissão de conteúdo.
“Associação Codaqui”“escola / empresa”Somos uma associação sem fins lucrativos (CNPJ 44.593.429/0001-05) — transparência é valor.

Hashtags oficiais

Trilhas e programa de estudo

Doações e financiamento coletivo

Projeto Mentoria

Clube de benefícios (SortCoins)