Como configurar o onboarding de usuários num app do Bolt.new sem programador
Um fluxo completo de primeira sessão num app do Bolt.new — boas-vindas, primeira ação guiada e lista de primeiros passos — com três itens do Clew que acompanham o usuário pelo app, em vez de um tour comprido no carregamento.
- Tempo
- ● 40 minutos
- Preço
- Tours grátis · resto no teste de 14 dias
- Quem faz
- Você e o chat do Bolt
Exemplo: onboarding de usuários num app do Bolt.new
Um criador de portfólios no Bolt.new. Boas-vindas em /projects, um tour do editor em /projects/new e, na terceira visita, um checklist: domínio próprio, título de SEO e link para compartilhar.
A parte do tour de produto é grátis no plano Free (até 3 publicados). Modal, Checklist e as regras de público fazem parte do Pro: toda conta nova ganha 14 dias de teste com tudo incluído, sem cartão. Quando o teste acaba, nada é apagado e o que foi publicado continua aparecendo.
Como configurar o onboarding de usuários num app do Bolt.new, passo a passo
- Passo 01
Copie o seu snippet do Clew
Crie uma conta grátis (ou entre), adicione o seu site e abra Visão geral no admin. Clique na linha do cartão O widget ainda não deu sinal. para copiar: ela já vem com a chave real do seu site no lugar do marcador.
<!-- Clew: troque COLE_AQUI_SUA_CHAVE pela chave do site em Admin > Visão geral --> <script src="https://tryclew.io/widget/COLE_AQUI_SUA_CHAVE.js" async></script>

Passo 1 · ilustração esquemática - Passo 02
Abra o projeto no Bolt.new
Abra o projeto em bolt.new. O Bolt roda o projeto no navegador e edita arquivos pelo chat.

Passo 2 · ilustração esquemática - Passo 03
Envie o prompt com a sua chave
Troque
COLE_AQUI_SUA_CHAVEpela sua chave e envie o prompt abaixo. Ele cobre a tag e o que o onboarding de usuários precisa.Adicione o widget de onboarding do Clew a este app. Insira esta tag exata uma única vez, para que carregue em todas as páginas, inclusive depois de mudanças de rota no cliente: <script src="https://tryclew.io/widget/COLE_AQUI_SUA_CHAVE.js" async></script> Este é um projeto do Bolt.new (normalmente Vite): coloque a tag no index.html da raiz logo antes de </head>; se for Next.js, use next/script no layout raiz. Depois do login, chame Clew.identify() com propriedades não pessoais como strings que diferenciem um usuário novo de um antigo, por exemplo { signup_source: "web", onboarded: "false", role: "owner" }, e atualize onboarded para "true" quando o usuário concluir a ação principal. Se o widget ainda puder não ter carregado, defina antes o stub de fila: window.TutorKit = window.TutorKit || { q: [], identify: function (p) { this.q.push(["identify", p]); } }; e chame window.TutorKit.identify(...). Adicione também atributos data-tour à navegação principal e ao botão principal de criar. Nunca envie nomes nem e-mails. Regras: - Use a URL do script exatamente como está. Não baixe, não empacote e não instale um pacote npm. - Se o projeto define uma Content-Security-Policy, permita https://tryclew.io em script-src e connect-src. - Não mude mais nada e me mostre o diff.
Passo 3 · ilustração esquemática - Passo 04
Revise os arquivos e faça o deploy
Confira que o
index.htmlganhou uma linha e que nada foi instalado do npm, e clique em Deploy (Netlify ou hospedagem do Bolt). A prévia dentro do Bolt não é o app de verdade.
Passo 4 · ilustração esquemática - Passo 05
Crie os três itens do onboarding
Em Fluxos crie três itens: um Janela modal com uma frase de boas-vindas e um link para a tela principal; um tour Tooltips passo a passo de 3–4 passos nessa tela, feito com Editar no seu site e Escolher elemento; e um Checklist de onboarding com as tarefas de configuração que faltam.

Passo 5 · ilustração esquemática - Passo 06
Escolha onde, quando e para quem aparece
No mesmo editor, preencha Onde mostrar (URL da página), Quando mostrar, Segmentação de público e Frequência. Estas são as configurações do exemplo acima:
Configuração Valor Pop-up de boas-vindas Formato Janela modal Onde mostrar (URL da página) Caminho exato /projectsQuando mostrar Assim que a página carregar Segmentação de público Sem regras: todo mundo que abre a página Frequência Uma vez por visitante Tour do produto Formato Tooltips passo a passo Onde mostrar (URL da página) Seção por prefixo /projects/newQuando mostrar Assim que a página carregar Segmentação de público Sem regras: todo mundo que abre a página Frequência Uma vez por visitante Checklist Formato Checklist de onboarding Onde mostrar (URL da página) Seção por prefixo /projectsQuando mostrar Na N-ésima visita: 3 Segmentação de público Sem regras: todo mundo que abre a página Frequência Uma vez por visitante 
Passo 6 · ilustração esquemática - Passo 07
Publique e confira no site real
Mude Status para Publicado e salve. Abra a página numa janela anônima: o Clew lembra quem já viu um item de “uma vez”, então o seu navegador de sempre pode pular. Visualizações, conclusões e abandonos aparecem nas estatísticas.

Passo 7 · ilustração esquemática
Armadilhas: onboarding de usuários num app do Bolt.new
A prévia no navegador usa uma origem temporária
A URL de prévia do Bolt muda entre sessões. Teste o onboarding de usuários no domínio publicado; os caminhos das regras de URL continuam os mesmos.
Um prompt de “conserta aí” pode reescrever o index.html
Quando o Bolt regenera o template do projeto, a tag pode sumir. Depois de regenerações grandes, confira na Visão geral do admin se o widget continua ativo.
As boas-vindas não podem aparecer para usuários antigos
“Uma vez por visitante” vale por navegador: um cliente antigo num notebook novo é um visitante novo. Se o seu app conhece o usuário, adicione uma regra sobre uma propriedade como onboarded para os antigos pularem as boas-vindas.
Não dispare tudo na mesma página
Se o pop-up, o tour e o checklist batem com a mesma URL, só um começa e os outros esperam. Dê a cada um a sua página ou gatilho, como na tabela acima.
Perguntas e respostas
Dá para testar o fluxo como usuário novo?
Use uma janela anônima: ela não tem memória do Clew, então tudo aparece como para quem acabou de chegar.
Preciso baixar o código do Bolt?
Não. O Bolt edita e publica o projeto; a linha do Clew entra com um prompt.
Quais partes são grátis?
Tours são grátis no plano Free. O pop-up de boas-vindas, o checklist e as regras de público estão no Pro; o teste de 14 dias inclui tudo, sem cartão.
Quanto tempo leva?
Uns quarenta minutos para a primeira versão: dez para o pop-up, vinte para o tour e dez para o checklist. Depois, melhore pelo funil.
O que mais dá para adicionar num app do Bolt.new
- Como criar um tour do produto num app do Bolt.new sem programador
- Como adicionar um checklist de onboarding num app do Bolt.new sem programador
- Como criar um aviso de paywall num app do Bolt.new sem programador
Onboarding de usuários em outras plataformas
- Google Tag ManagerComo configurar o onboarding de usuários com o Google Tag Manager sem programador
- LovableComo configurar o onboarding de usuários num app do Lovable sem programador
- v0Como configurar o onboarding de usuários num app do v0 sem programador
- ReplitComo configurar o onboarding de usuários num app do Replit sem programador
- CursorComo configurar o onboarding de usuários num app feito no Cursor sem programador
- Claude CodeComo configurar o onboarding de usuários com o Claude Code sem programador
- ChatGPT CodexComo configurar o onboarding de usuários com o ChatGPT Codex sem programador
- Qwen CodeComo configurar o onboarding de usuários com o Qwen Code sem programador