Wizard

Fluxo guiado em etapas, para uma tarefa que é grande demais para uma tela só (cadastrar fornecedor, importar planilha, criar cotação). Conduz a pessoa passo a passo, validando cada etapa antes de avançar. Usa o chassi do ME (header + subheader); os campos de cada etapa vêm de Componentes › Formulários.

Quando usar

Uma tarefa longa e sequencial que se beneficia de ser quebrada em passos.
Quando cada passo precisa validar antes do próximo, e a ordem importa.
Onboarding / criação assistida (ex.: novo fornecedor em 5 passos).

Quando NÃO usar:

Cenário	Use
Criar/editar um registro num único formulário	Formulário — não wizard
Navegar entre fases de um documento de processo (rodadas de Cotação/Leilão)	Phases — é rail de documento, não wizard
Trocar de seção dentro do mesmo registro (Itens, Histórico)	Tabs

Anatomia

Três zonas:

Indicador de progresso (passos) — um stepper que mostra as etapas e a atual ("Passo 2 de 4"). Reflete o estado: concluída · atual · futura (com sinal redundante à cor).
Conteúdo da etapa atual — só o passo ativo é exibido; o corpo troca conforme a navegação.
Rodapé de ações — Voltar + Avançar; opcionalmente "Salvar rascunho"/"Cancelar". No último passo, "Avançar" vira Concluir.

Tipos de conteúdo por etapa

Cada etapa tem um tipo de conteúdo — combine conforme a tarefa:

Tipo	Para
Formulário	Coletar campos (o mais comum).
Tabela / lista	Selecionar/revisar itens em lote.
Documentos	Anexar/enviar arquivos.
Resumo / Revisão	Mostrar o que foi preenchido antes de confirmar.
Confirmação	Estado final de sucesso + próximos passos.

Regras

Valide a etapa antes de avançar — não deixe seguir com pendências do passo atual.
"Concluir" no último passo, não "Avançar" — deixa claro que ali termina.
O stepper reflete a etapa ativa e o corpo mostra o conteúdo dela (sempre em sincronia).
Permita voltar sem perder o que já foi preenchido.

Responsivo

Desktop: stepper na horizontal (ou lateral); rodapé de ações inline.
Mobile/tablet: o stepper compacta ("Passo X de N" textual); os campos empilham; as ações vão para um rodapé fixo (Voltar/Avançar acessíveis com o polegar).

Componentes da tela

Priorize o EletroDS; Nuxt UI é fallback.

Zona	Componente	Papel
Título + progresso + ações	Subheader	Título do fluxo + "Passo X de N" + Voltar/Avançar.
Indicador de passos	Stepper (Nuxt UI `UStepper`)	Mostra as etapas e a atual.
Ações do rodapé	Button bar	Voltar (secundário) + Avançar/Concluir (primário).
Campos da etapa	Componentes › Formulários	Input, Select, etc. na etapa de formulário.

DESIGN? Ainda sem mock visual dedicado e sem definição de detalhes finos (stepper horizontal × lateral; comportamento exato do "voltar" com estado). A referência visual atual é o preview shadcn vibe-react/src/previews/WizardPreview.tsx e o modelo no Compositor. Formalizar a anatomia visual (mock context-visual) fica pendente de design.

Veja tambémFormulário Phases Estrutura de documento