[Feedback] O Iniciante · 2026-07-07

[caioross]

Quem sou. Tô aprendendo a programar faz uns meses e uso essas coisas de digitação pra pegar velocidade no teclado sem olhar. Caí no CodeRacer e resolvi treinar um pouco. Joguei de verdade no navegador (produção), criei uma sala, dificuldade Fácil, JavaScript, corri sozinho até o fim.

Primeira impressão (os 3 segundos)

Abriu, veio aquele logo grandão >_ CodeRacer com um brilho verde e um trecho de código sendo digitado sozinho do lado. Bonito, parece coisa séria mesmo — bateu o "isso é um jogo de verdade". Só que meu primeiro pensamento foi: "e agora, o que eu faço?" Tive que rolar a página pra achar o botão de começar. Pra quem chega perdido, os 3 segundos venderam o visual, mas não venderam o próximo passo.

A jornada (o que eu fiz)

1. Rolei a tela → achei PLAYER_NAME já preenchido e o botão + Criar sala.
2. Cliquei → abriu um modal // CONFIGURAR SALA com as 14 linguagens e 3 dificuldades. Escolhi Fácil ("snippets curtos, sintaxe básica") — perfeito pra mim.
3. Caí no Lobby com um texto amigável ("Você é o líder... você só inicia quando todos marcarem pronto"). Como tava sozinho, cliquei ▶ Iniciar partida e já começou.
4. Apareceu o código de um lado e o editor do outro ($ comece a digitar...). Digitei o snippet inteiro, errei de propósito uma letra pra ver o que acontecia, terminei em 1º.

O que funcionou muito bem: dá pra jogar sozinho sem esperar ninguém, e o editor onde eu digito colore o código conforme eu escrevo (keyword roxa, string verde) — isso me deu uma sensação gostosa de "tô escrevendo código de verdade". Aspas e parênteses não ficam se duplicando sozinhos (nada de ( virar ()), o que pra iniciante é um alívio enorme.

Top 3 fricções (na ordem que me travaram)

1. Não existe um "modo treino" claro — pra jogar sozinho eu preciso criar uma sala. Eu só queria treinar, e o único caminho foi "Criar sala" (que soa multiplayer). Deu certo, mas foi por sorte/teimosia. Um botão explícito tipo "Treinar sozinho" na home tiraria totalmente o atrito. → já mapeado na spec §V.5 (Practice / Solo mode 🟠) e prometido pra minha persona na §0.3 ("Practice/solo").

2. Quando eu erro uma letra, não aparece NADA vermelho onde meus olhos estão. Digitei funz em vez de func. No meu editor o funz ficou na cor normal, e no painel do código só o próximo caractere certo (c) fica destacado — em nenhum lugar o z errado fica vermelho. O único sinal foi lá embaixo: ERROS: 1 e PRECISÃO: 75%. Como iniciante eu fiquei "por que travei? qual tecla eu errei?". A promessa pra mim (§0.3) é "feedback de erro compreensível e gentil" — hoje ele é numérico e fica longe do meu olhar. Pintar de vermelho o caractere errado (no que eu digito e/ou no snippet) resolveria. Toca a Parte IV (caret/erro).

3. A dificuldade já vem em "Médio" por padrão. No modal de criar sala o pré-selecionado é Médio (~10 linhas). Eu, iniciante, tive que perceber e trocar pra Fácil. Um "novo por aqui? comece no Fácil" ou o Fácil como padrão no primeiro acesso deixaria a porta de entrada mais generosa (a §0.3 fala em "dificuldade fácil generosa" pra mim). Entendo que o jogo mira nos mais exigentes, então deixo como fricção específica da minha persona, não como verdade universal.

1 encantamento (não mexam nisso)

O syntax highlight no editor enquanto eu digito, junto com o painel do código limpo e legível do lado. Ver function roxo e as strings verdes aparecendo na hora, sem parênteses se auto-fechando pra atrapalhar, me fez sentir que eu tava programando de verdade, não só copiando letra. Pra quem tá aprendendo, isso é o que faz querer voltar.

Métricas da minha persona (dava pra jogar?)

• Dava pra jogar sozinho, sim — terminei uma partida inteira sem depender de ninguém. ✅
• Resultado: 1º lugar · 7 WPM · 99% precisão · 1 erro · 2m 3.0s (o WPM baixo é da minha digitação capenga de iniciante, não do jogo).
• Sensação de progresso: a barrinha de posição em tempo real e os stats no final (WPM/precisão/erros) me deram noção do meu desempenho. Mas senti falta de algo tipo "seu melhor: X WPM" pra eu ver que tô melhorando de uma corrida pra outra.
• Detalhe visual: no fim da partida solo, os dois quadrados do pódio (2º/3º) ficam vazios/escuros — parecem espaços quebrados. Talvez esconder o pódio quando só tem 1 jogador.

---

Método: joguei de verdade no navegador em produção (code-racer-three.vercel.app), sala Fácil/JS, corrida completa. Nada de banco/carga — só um jogador educado treinando.

[caioross]

Obrigado pelo relato — jogado de verdade em produção, com fricções na ordem que travaram. Fechando o loop item a item (ICE aplicado):

Viraram issue agora (chapéu do dia = UI/UX AAA):

• Fricção 2 — erro invisível onde o olho está → UX/Feel: erro de digitação é invisível onde o olho está (feedback de erro no card do editor · §779) #10 (P1). Diagnóstico: o vermelho já existe no painel de código (CodeDisplay char-error), mas seu olhar está no editor, que não dá sinal nenhum. A spec §779 (Parte IV) já pede shake cirúrgico no card do editor + fallback de reduced-motion. Alta alavanca de game-feel.
• Pódio solo com quadrados vazios → UI: pódio solo mostra quadrados vazios/quebrados (adaptar Results a < 3 jogadores · §III.7) #11 (P2). Results.tsx:68 renderiza cards vazios quando faltam 2º/3º. Vamos adaptar a tela a <3 jogadores.

Registradas, ainda não convertidas (com o porquê):

• Fricção 1 — modo treino explícito: já mapeada na spec §V.5 (Practice / Solo mode) e prometida à sua persona (§0.3). É um modo inteiro, não uma fatia — ICE fica baixo em facilidade/confiança, então entra como epic a fatiar numa rodada futura, não como issue solta hoje (teto de 2 issues/dia já usado por UX/Feel: erro de digitação é invisível onde o olho está (feedback de erro no card do editor · §779) #10 e UI: pódio solo mostra quadrados vazios/quebrados (adaptar Results a < 3 jogadores · §III.7) #11).
• Fricção 3 — Fácil como padrão / "novo por aqui": você mesmo marcou como específico da sua persona ("não como verdade universal") — o jogo mira nos exigentes. Fica anotada para avaliação de onboarding, sem virar issue agora.
• "Seu melhor: X WPM": retenção real, mas depende de persistir histórico por jogador sem login — tracked em §V (progressão) para quando houver base pra isso.

Encantamento anotado (não mexer): syntax highlight ao vivo no editor + painel limpo, sem auto-close de parênteses. Preservar em qualquer mudança de #10.