Acabamento mobile: aprendizados do Atlas Mobile (primeira execução, título de aba, lista agrupada, vazio com próximo passo, erro para pessoas, painel de status, sem salto de layout)
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Accessibilité débutants
- 25/100
- Type d'issue
- Fonctionnalité
- Clarté
- Plutôt claire
- Activité
- Active
- Stack technique
- typescript
Piste de recherche
Read the linked Atlas Mobile review (#435), the reference implementation in lib/core/ui/, and linked library issues #1238, #1174, and #1104. The request spans ten proposed components, recipes, and testing tools, so first identify one item to split into a focused issue. Done means each focused item has its component or recipe and a test that reproduces the described defect.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Contexto
Revisão de produto do Atlas Mobile num iPhone real (codeatlasdev/atlas#435). O app é Flutter, então não usa a lib, mas as falhas que o dono viu são de padrão e não de framework, e a lib promete "native-feeling mobile". Cada item abaixo diz o que quebrou, a regra que resolveu, o que a lib deveria oferecer (componente, receita ou lint) e as issues abertas ligadas. A implementação de referência em Flutter está no PR citado (lib/core/ui/).
O critério do dono: nada pode parecer "vibecodado". Botão solto, faixa sobre conteúdo, vazio que só informa e número que rola de lado são defeitos.
1. Primeira execução não mora dentro de uma aba
Quebrou: o onboarding era o conteúdo da aba Home, então a tab bar flutuante ficou por cima de Continue e Skip e ofereceu abas sem nada para mostrar.
Regra: a primeira execução é do shell. Ela fica em tela cheia, com as abas montadas por baixo (offstage, sem tickers) para a Home já estar conectando quando o fluxo acaba. Uma regra só decide isso (no Atlas: nada pareado), sem escrita de estado a partir de build.
Para a lib: AppShellLayout com um modo fullscreen/firstRun que esconde a navegação e mantém as rotas vivas por baixo, mais um teste de contrato: nenhum botão primário pode estar sob a barra (hit-test). Ligadas: #1238, #1174, #1104.
2. Título de aba com os controles na mesma linha
Quebrou: cada aba montava o título à mão, com paddings diferentes. Na aba Crew, "Pause all" e o botão de opções flutuavam soltos abaixo do título.
Regra: um componente de linha de título. Ele tem altura mínima de 48, o título como header na árvore de acessibilidade e as ações da tela à direita. Todas as abas abrem igual. Quando há várias entidades (vários servidores), vira uma linha nomeada por entidade abaixo do título.
Para a lib: PageTitle/TabTitle mobile com slot de ações e regra de overflow (as ações viram menu quando não cabem). Ligadas: #1044, #1107, #736.
3. Lista agrupada estilo ajustes
Quebrou: Settings era um card, um link e uma linha de privacidade, com um vazio enorme embaixo.
Regra: grupos com título em muted e rodapé opcional (uma frase do porquê). As linhas são:
- ícone num tile tingido de 32 px;
- título e subtítulo;
- altura mínima de 56;
- divisor com recuo que começa no texto, não na borda.
O fim da linha diz o tipo: chevron navega, seta "↗" abre fora (com link na semântica), "info" mostra valor sem ação, e um trailing (menu, switch) reduz o padding final para o ícone cair onde o chevron cairia. Uma linha de status aceita um ponto de estado antes do subtítulo.
Para a lib: NativeList / GroupedList com esses tipos de linha. Ligadas: #1133, #1239, #1161.
4. Estado vazio sempre leva a algum lugar
Quebrou: a aba Crew sem servidor dizia "No crew yet" e parava ali.
Regra: vazio, não configurado, erro e carregando são estados diferentes, e cada um tem o próximo passo:
- Não configurado: explica o recurso em uma frase, oferece a ação primária ("Pair a crew server") e um link de guia ("How to install a crew server ↗").
- Vazio: oferece a ação de criar (Recruit).
- Carregando: nunca mostra "vazio".
Para a lib: EmptyState com guide={label, href} além de action, e uma receita que nomeia os quatro estados. Ligadas: #992, #1060, #1198.
5. Erro dito para pessoas
Quebrou: erros mostravam o texto cru do servidor ("forbidden", stack de Rust).
Regra: um objeto Problem com título, uma frase, passos numerados (comandos entre crases viram chip de código) e o texto cru em "Details" recolhido e copiável. A classificação por tipo dá títulos estáveis:
- offline: "Can't reach X";
- versão: "Atlas on X is out of date";
- permissão: "This phone isn't allowed to do that";
- timeout.
As ações ficam num Wrap, porque "Try again" mais "Details" estourou em 320 pt.
Para a lib: ErrorState/Problem com essa forma, mais um teste de layout em 320 px com texto 2x. Ligada: #1290 (detector de texto cru).
6. Painel de status: estado, a ação dele e os números num bloco
Quebrou (print do dono): a pílula "Stopped" e um "Start" grande ficavam lado a lado soltos acima de um card de números. Um projeto parado mostrava "0/6 running" em vermelho.
Regra:
- Um painel com o estado em palavras ("Stopped · 6 services, none running", ou "Running · up 1h 20m · pid 4821") e a sua única ação (Start, que vira "Starting…" desabilitado em voo), com divisor e os números embaixo.
- Parado não é alarme: 0/6 fica neutro, e memória e CPU de nada são "—", não "0 MB".
- Números nunca rolam de lado: cada KPI tem largura natural, distribuídos com
spaceBetweene quebrando linha quando não cabem. Colunas iguais colaram "646 MB18%".
Para a lib: receita StatusPanel e KpiRow com essas regras de semântica (cor só quando há ação a tomar). Ligadas: #1157, #486, #55.
7. Nada muda de altura enquanto os dados chegam
Quebrou (os testes de frame pegaram):
- A linha "Connected · Atlas 1.0.0" quebrava em duas quando a versão chegava e empurrava a página.
- Uma linha de notificações nova pulou 114 px num frame.
- Um placeholder de altura mágica (64) não batia com a linha real.
Regra:
- Linha de status ao vivo é
maxLines: 1com reticências. - Conteúdo que entra abre o espaço animando (um passo só com Reduce motion), nunca de uma vez.
- O placeholder é o mesmo widget invisível, não uma altura fixa, então segura a altura certa em qualquer escala de texto.
Para a lib: um primitivo GrowIn/MotionSize, e uma regra de lint para "skeleton tem a forma do conteúdo". Ligadas: #1068, #1197.
8. Chão do app sob todas as rotas
Quebrou: com os scaffolds transparentes (fundo compartilhado com brilho), sheet e tela sem fundo próprio mostravam a janela por trás (branco nos goldens, preto no aparelho).
Regra: um "chão" (ground) no builder do app, sob todas as rotas, e o fundo decorado por cima.
Para a lib: documentar a camada de chão vs o fundo de página no tema, e garantir que todo overlay herde o chão. Ligada: #1299.
9. Links externos num lugar só
Quebrou: a política de privacidade apontava para o GitHub enquanto o site tinha a página. URLs espalhadas.
Regra: um módulo de links (site, docs por página e âncora, privacidade, código), e openLink sempre no navegador.
Para a lib: uma receita de "links do produto", e o tipo "external" da linha (item 3) usando o mesmo helper.
10. Como pegamos tudo isso sem olhar tela por tela
- Harness de layout: toda tela em 320×568, 360×640 e 393×852, com texto 1x e 2x, notch e home indicator. Falha em overflow.
- Frame probe: grava a posição de partes nomeadas frame a frame e falha se algo pula mais que uma fração do movimento, ou se duas páginas aparecem ao mesmo tempo.
- Tour headless: um teste que carrega a fonte do sistema e grava PNG de 13 telas em 7 s, para revisão de design sem aparelho.
- Mutation check: todo teste novo foi visto falhando com o bug reintroduzido.
Para a lib: é o pacote de detectores de #1290, mais o tour como modo do site (todas as receitas em 3 larguras e 2 escalas de texto, num lugar só).
Aceite sugerido: cada item vira uma issue própria, ou fecha numa issue ligada. A lib publica, para cada um, o componente ou a receita, mais um teste que falha no defeito descrito.
- Langage dominant
- TypeScript
- Étoiles
- 6
- Forks
- 3
- Merge moyen
- 5 h 21 min
- PR mergées (30 j)
- 378
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de codeatlasdev/ui
-
Difficulté 2/5 1-3 heures Accessibilité débutants 84/100
codeatlasdev/ui#1340 ·
Les mainteneurs répondent en général sous 1 jour
-
area:a11y area:components bug
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
codeatlasdev/ui#1336 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 77/100
codeatlasdev/ui#1329 ·
Les mainteneurs répondent en général sous 1 jour
-
good first issue
Difficulté 2/5 1-3 heures Accessibilité débutants 74/100
codeatlasdev/ui#1292 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
area:components enhancement good first issue
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
codeatlasdev/ui#1198 ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de codeatlasdev/ui
Issues similaires
-
bug frontend
Difficulté 2/5 1-3 heures Accessibilité débutants 85/100
CivicTechWR/accessible-housing-portal#578 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
nekko-labs/nekko-agent#2998 ·
Les mainteneurs répondent en général sous 1 jour
-
Console writes URL credentials to the local log, though AGENTS.md says secrets never reach diskOuverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 86/100
sandbox-quantum/switch#2163 ·
Les mainteneurs répondent en général sous 1 jour
-
enhancement ux
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
lolimmlost/aidj#433 ·
Les mainteneurs répondent en général sous 1 jour
-
test: ipcShownDialogKeys.test.tsx can fail the unit run with 'window is not defined' after it endsOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
Les mainteneurs répondent en général sous 1 jour