Como configurar o onboarding de usuários num app do Lovable sem programador
Um fluxo completo de primeira sessão num app do Lovable — 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 Lovable
Exemplo: onboarding de usuários num app do Lovable
Um app de hábitos no Lovable. Quem acabou de se cadastrar (o app define signup_source no cadastro) vê as boas-vindas em /dashboard, um tour em /habits quando abre a seção e um checklist a partir da segunda visita.
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 Lovable, 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 chat do projeto no Lovable
Abra o seu projeto no Lovable. O chat edita o código direto; confira se você está na versão principal que publica, não num remix antigo.

Passo 2 · ilustração esquemática - Passo 03
Envie o prompt com a sua chave
Copie o prompt, troque
COLE_AQUI_SUA_CHAVEpela sua chave e envie. Além da tag, ele pede o que o onboarding de usuários precisa do código.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 Lovable (React + Vite): coloque a tag no index.html logo antes de </head>. 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
Confira a mudança e publique
Abra a visualização de código: espere o
index.htmlcom uma linha a mais e os pequenos acréscimos do prompt. Depois clique em Publish: o widget só funciona no app publicado.
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 /dashboardQuando mostrar Assim que a página carregar Segmentação de público Propriedade signup_sourceexisteFrequência Uma vez por visitante Tour do produto Formato Tooltips passo a passo Onde mostrar (URL da página) Seção por prefixo /habitsQuando 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 /dashboardQuando mostrar Na N-ésima visita: 2 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 Lovable
A autenticação do Supabase carrega depois da página
Apps do Lovable costumam fazer login com Supabase, então o usuário é conhecido um instante depois do carregamento. Tudo bem: Clew.identify() reavalia as regras a cada chamada, e o onboarding de usuários aparece nessa hora.
A prévia do editor não é o app publicado
Monte e teste o onboarding de usuários na URL publicada (ou no seu domínio). As regras de URL comparam caminhos, então as mesmas configurações valem para os dois.
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
E se a pessoa se cadastrar pelo celular?
O widget funciona em navegadores móveis; mantenha as boas-vindas curtas e os passos do tour em elementos visíveis em telas pequenas.
Os próximos prompts no Lovable vão remover a linha?
Normalmente não: ela fica no index.html. Se depois de uma grande regeneração a Visão geral do admin deixar de mostrar o widget ativo, envie o prompt de novo.
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 Lovable
- Como criar um tour do produto num app do Lovable sem programador
- Como adicionar um checklist de onboarding num app do Lovable sem programador
- Como criar um aviso de paywall num app do Lovable 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
- Bolt.newComo configurar o onboarding de usuários num app do Bolt.new 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