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)
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 25/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bastante claro
- Estado de actividad
- Activo
- Stack tecnológico
- typescript
Línea de trabajo
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.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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.
- Lenguaje dominante
- TypeScript
- Estrellas
- 6
- Forks
- 3
- Merge medio
- 5 h 21 min
- PR fusionados (30 d)
- 378
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de codeatlasdev/ui
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
codeatlasdev/ui#1340 ·
Los mantenedores suelen responder en 1 día
-
area:a11y area:components bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
codeatlasdev/ui#1336 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 77/100
codeatlasdev/ui#1329 ·
Los mantenedores suelen responder en 1 día
-
good first issue
Dificultad 2/5 1-3 horas Aptitud para principiantes 74/100
codeatlasdev/ui#1292 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
area:components enhancement good first issue
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
codeatlasdev/ui#1198 ·
Los mantenedores suelen responder en 1 día
Todos los issues de codeatlasdev/ui
Issues similares
-
Console writes URL credentials to the local log, though AGENTS.md says secrets never reach diskAbierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 86/100
sandbox-quantum/switch#2163 ·
Los mantenedores suelen responder en 1 día
-
automated issue report
Dificultad 1/5 Menos de una hora Aptitud para principiantes 78/100
Los mantenedores suelen responder en 1 día
-
area/dashboard kind/bug QA/dev-automation
Dificultad 1/5 Menos de una hora Aptitud para principiantes 75/100
Los mantenedores suelen responder en 1 día
-
bug pydanty:is-working
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
pydantic/pydantic-ai#13939 ·
Los mantenedores suelen responder en 1 día
-
self-host
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
funmusicplace/mirlo#2625 ·
Los mantenedores suelen responder en 1 día