AbacatePay / AbacatePay/ecosystem

Hero da página inicial não garante contraste de texto sobre a imagem de fundo

Aperta
#38 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
TypeScript
Stelle
8
Fork
5
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

**Descrição:**
O hero da página `/pages/start/welcome` usa uma `backgroundImage` com
texto sobreposto (título em branco, parágrafo em cinza claro/opacidade),
mas não há overlay/gradiente escuro fixo entre a imagem e o texto.

Isso já causa um problema visível hoje: onde o parágrafo de introdução
cruza a faixa mais clara (verde) da imagem de fundo, o contraste cai
sensivelmente em relação ao trecho sobre o fundo preto (ver screenshots
em anexo, Print 1: contexto geral do hero; Print 2: zoom nas linhas
finais do parágrafo, onde a perda de contraste é mais evidente).

**Por que isso precisa ser corrigido:**
- É a primeira página que qualquer desenvolvedor vê ao acessar a
documentação, um problema de legibilidade logo no topo passa uma
impressão de descuido, especialmente numa doc voltada para devs atentos a detalhes técnicos.
- Contraste insuficiente fere a diretriz WCAG 2.1 (nível AA, critério 1.4.3), que exige razão mínima de 4.5:1 entre texto e fundo, texto sobre a faixa verde provavelmente não atinge esse mínimo.
- Afeta ainda mais usuários com baixa visão, e piora em telas de celular sob luz solar direta, onde o brilho reduz o contraste percebido ainda mais.
- Como a imagem de fundo pode ser trocada no futuro (nova arte, campanha, etc.), corrigir com um overlay fixo resolve o problema de forma permanente, em vez de depender de a próxima imagem
"calhar" de ser escura o suficiente.

**Sugestão de correção:**
Adicionar um gradiente escuro fixo entre a imagem e o texto, por exemplo:
background: linear-gradient(rgba(0,0,0,0.5), rgba(0,0,0,0.5)), url('...');

Isso garante contraste mínimo independente das áreas claras/escuras
da imagem de fundo.

![Screenshot_2026-07-19-12-04-09-468_com.android.chrome.jpg](https://github.com/user-attachments/assets/c150e66c-cf94-4382-b3b1-1d920197188e)

![IMG_20260719_120758.jpg](https://github.com/user-attachments/assets/7640dfc6-f5b5-4e44-8f97-3eb528757940)

Posso trabalhar nessa correção! Um overlay/gradiente escuro sobre o
background do hero resolveria. Fico no aguardo de aprovação antes de
abrir o PR.

Guida per i contributori

Apri la guida per i contributori

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.