O Shell: navegação, busca (⌘K), notificações e tema

Onde: a moldura fixa em volta de toda tela

Visão geral

Depois de logar, tudo acontece dentro do Shell: um menu lateral (esquerda) e uma barra superior (topo) que permanecem enquanto a tela central muda. Este capítulo é o mapa da navegação — onde fica cada coisa e como se movimentar rápido.

Quando usar

• Sempre. É a sua bússola: todo capítulo deste guia é aberto a partir daqui.

Pré-requisitos

• Estar logado (Cap. 1).

Passo a passo (por região)

Menu lateral (Sidebar)

Organizado em três seções + rodapé, nesta ordem:

Seção	Item	Abre
Treino	Dashboard	Cap. 3
	Atletas	Cap. 4 · Cap. 5
	Usuários	Cap. 15
	Programação	Cap. 8
	Programas	Cap. 20
	Construtor	Cap. 7
	Importar planilha	Cap. 19
	Biblioteca	Cap. 6
	Competições	Cap. 18
Acompanhamento	Resultados	Cap. 9
	Leaderboard	Cap. 16
	Analytics	Cap. 10
	Mensageria	Cap. 11
Equipe	Organização · Equipe · Aulas · Grade padrão · Avaliação	Cap. 17
	Matrículas	Cap. 21
	Check-ins	Cap. 22
(rodapé)	Configurações	Cap. 13

Nota

o menu mostra só o que o seu perfil de acesso abre. Construtor e Programas aparecem para quem autora treino; na seção Equipe, tudo é do head coach menos a Organização, que qualquer coach abre (a tela em si fica somente leitura para quem não é head coach). Uma seção sem nenhum item visível não aparece.

Nota

o menu encolhe sozinho para a faixa de ícones quando a janela fica com menos de 1024px de largura — e isso vale mesmo que você o tenha deixado aberto. Não é o app esquecendo sua escolha: nessa largura o menu aberto come um quarto da tela de trabalho. Alargue a janela e ele volta como você o deixou. Abaixo de 840px o cockpit sai do ar e avisa por quê: o Construtor monta a semana numa grade que não cabe num celular. Para treinar no celular, o app é o do atleta.

Nota

a Organização é o primeiro item da seção Equipe e abre o cadastro da organização (Cap. 17). Até 25/09/2026 ela se chamava Box. Ela já foi um cartão acima do menu, com a marca e um menu próprio; o cartão saiu porque três dos quatro atalhos que ele abria — Equipe, Aulas e Grade padrão — já eram itens do menu logo abaixo. Não há troca de organização/empresa em lugar nenhum (modelo de head coach único): a marca é um contexto fixo.

Nota

a assinatura, no topo do menu, diz RIG e, embaixo, COACH — o produto em cima, a aplicação embaixo, como no app do atleta (Rig Athlete). Ela já disse Elite · Performance e Coach · Impacto Fitness. Com o menu recolhido na faixa de ícones, sobra só o monograma.

Barra superior (Topbar)

📸 Screenshot pendente

assets/02-shell-topbar.png — a barra sem a caixa de busca: título à esquerda, quatro botões à direita.

Da esquerda para a direita:

1. Título da tela atual (ex.: “Dashboard”, “Construtor de Treino”).
2. Buscar e comandos (⌘K) — abre o command palette, que é onde se busca e se navega.
3. Sino de notificações — com um badge de não-lidas; abre o painel de notificações.
4. Alternar tema (claro/escuro).
5. Avatar / iniciais do coach.

Nota

a barra larga escrita “Buscar atletas, treinos, movimentos…” saiu. Ela nunca foi um campo — não dava para digitar nela; clicar abria o command palette, exatamente o que o botão faz. Eram duas portas para a mesma sala, e a maior ocupava um terço da barra. A busca não sumiu: ⌘K, ou o botão, e você digita direto.

Command palette (⌘K)

📸 Screenshot pendente

assets/02-shell-command-palette.png — a captura no arquivo é da versão antiga (ela mostra Criar novo WOD e três atletas que não existem).

Abra com ⌘K, ou pelo botão de comandos na barra superior. É a forma mais rápida de chegar a qualquer lugar do cockpit: digite, ande com as setas e confirme com Enter. ESC fecha, e ⌘K de novo também.

Ela busca cinco coisas ao mesmo tempo:

O que	O que aparece à direita	Para onde leva
Telas	—	a tela
Ações	o valor atual, quando a ação tem um	executa na hora
Atletas	o tier (ou desativado)	o perfil daquele atleta
Movimentos	a categoria	a Biblioteca, já filtrada por ele
Programas e coaches	o nível / o tipo de coach	a ficha

Sem nada digitado, ela mostra o que você usou por último e, embaixo, a lista de telas e ações — é um menu. A lista longa só aparece quando você diz o que procura.

A busca perdoa. Não precisa acertar acento (programacao acha Programação), não precisa escrever tudo (bksq acha Back Squat) e não precisa saber o nome da tela: ela também procura pelo apelido. wod acha o Construtor, ranking acha o Leaderboard, box acha a Organização, agachamento acha o Back Squat, e o e-mail acha o atleta. O trecho que casou aparece sublinhado na linha.

Dica

um símbolo no começo restringe a busca a um tipo só — > ações, @ atletas, # movimentos, / telas. Digitar só @ já lista os atletas. Os quatro estão escritos no rodapé da paleta.

As ações que executam na hora, sem sair de onde você está:

• Alternar o tema e Alternar a densidade — a paleta fica aberta e o valor à direita vira na sua frente, para você ver o resultado e voltar atrás se não gostou.
• Recolher / Expandir o trilho — o menu lateral.
• Novo programa — este sai da paleta e abre o formulário.

📐 Regra de negócio

a paleta mostra só o que o seu acesso já mostra no menu. Quem não tem autoria não vê Programas nem Construtor; quem não é head coach não vê Equipe, Aulas, Grade padrão nem Avaliação — e a busca desses coaches nem chega a pedir essas listas.

Cuidado

a paleta navega e ajusta preferência; ela não cria nem publica dados. Escolher um movimento não o edita — leva você à Biblioteca com ele na busca. Novo programa abre o formulário em Programas, e é lá que o programa nasce.

Nota

ela lê os atletas, movimentos, programas e coaches na primeira vez que você a abre, não antes — e revalida sozinha depois de um minuto. Se uma dessas listas falhar, as outras continuam funcionando e o rodapé oferece tentar de novo.

Sino de notificações (painel)

Abre a lista de não-lidas, cada uma com o tempo relativo (“agora”, “há 5 min”, “há 2 h”, “há 3 d”). Clicar marca como lida; há “marcar todas”. Notificações de mensagem levam direto à Mensageria. Detalhes no Cap. 12.

Tema

Alterna claro/escuro. A escolha é salva no navegador e mantida entre sessões — e já vale no primeiro instante do carregamento, sem piscar escuro antes de abrir.

Nota

no claro nenhuma tela tem bloco escuro. A hierarquia vem de fios, tipografia e superfícies quase brancas; o amarelo continua sendo o destaque, só que como texto ele aparece num tom mais fechado, que se lê sobre branco. Controle selecionado (aba, chip de filtro, botão de ação forte) continua preenchido de preto — é assim que ele diz que está ligado.

Navegação & histórico

Cada tela tem uma URL própria (/dashboard, /athletes, /athletes/:id, /schedule, /programas, /programas/:id, /builder, /library, /results, /analytics, /messages, /settings). Os botões voltar/avançar do navegador funcionam, e você pode compartilhar/favoritar o link de uma tela (ex.: o perfil de um atleta, ou a página de um programa).

Estados

• Cada tela central carrega com skeleton próprio; o Shell (menu + barra) fica sempre visível depois de autenticado.

Dicas

Dica

⌘K é o atalho universal — de qualquer tela, é o caminho mais curto para navegar ou pular para a autoria.

Erros comuns / troubleshooting

• “O badge do sino não zera.” — Abra o painel e use marcar como lida / marcar todas; o contador reflete as não-lidas.
• “Voltar no navegador me tirou do sistema.” — Voltar navega o histórico de telas; se você voltar antes do login, cai na tela de acesso — é esperado.

Como o atleta vê

Não se aplica — o Shell é a moldura do app do coach.