Criando seu primeiro App

Este guia mostra como criar um App a partir de um workflow do Canvas. Ao final, você terá uma ferramenta reutilizável que qualquer pessoa pode usar.

Pré-requisitos

Antes de criar um App, você precisa de:

• ✅ Um workflow do Canvas funcionando
• ✅ O workflow testado e produzindo bons resultados
• ✅ Entendimento de quais inputs devem ser alteráveis

Etapa 1: construa seu workflow

Primeiro, crie e teste seu workflow no Canvas.

Exemplo de workflow

Vamos criar um gerador simples de fotos de produto:

[Upload Node] → [BG Remover] → [Image Node (Flux Kontext)] → [Upscaler]
                                        ↑
                              [Text Node: "on marble surface, studio lighting"]

Teste

1. Execute o workflow com inputs de exemplo
2. Verifique a qualidade do output
3. Ajuste configurações até ficar satisfeito
4. Salve o Canvas

Etapa 2: abra o App Builder

Como acessar

1. Abra seu workflow do Canvas
2. Procure o botão App Builder na toolbar (ou sidebar)
3. Clique para abrir o painel do App Builder

O painel do App Builder

Você verá:

• App list — Apps existentes para este Canvas
• Create New — Botão para começar um novo App
• Settings — Opções de configuração

Etapa 3: nomeie seu App

Nome do App

Escolha um nome claro e descritivo:

✅ Bons nomes:

• “Product Photo Generator”
• “Social Media Post Creator”
• “Video Ad Maker”

❌ Evite:

• “My App”
• “Test”
• “Workflow 1”

Descrição

Escreva uma breve descrição do que o App faz:

Generate professional product photos with custom backgrounds. 
Upload your product image, describe the desired background, 
and get a polished, high-resolution result.

Etapa 4: configure inputs

Esta é a etapa mais importante. Você está escolhendo quais partes do seu workflow os usuários podem mudar.

Encontrando inputs disponíveis

O App Builder mostra todos os nodes que podem aceitar input:

• Text nodes (para prompts)
• Upload nodes (para arquivos)
• Configurações que podem ser modificadas

Selecionando inputs para expor

Para cada input que você quiser expor:

1. Ative (toggle on) — Torna visível para usuários do App
2. Defina o label — O que o usuário vê (ex.: “Product Photo”)
3. Defina o tipo — Text, image, video, ou audio
4. Marque como obrigatório — Se o usuário precisa fornecer esse input

Exemplo de configuração

Para nosso workflow de foto de produto:

Labels de input

Escreva labels claros e amigáveis:

✅ Bons labels:

• “Product Photo”
• “Background Description”
• “Brand Name”

❌ Evite:

• “input_1”
• “Text for node 3”
• “Upload here”

Etapa 5: adicione uma thumbnail

Uma thumbnail ajuda os usuários a identificar seu App.

Opções

1. Upload de uma imagem — Sua própria thumbnail
2. Usar do workflow — Um output gerado
3. Selecionar dos assets — Da sua Gallery

Boas práticas

• Use um resultado do seu workflow
• Mostre o que o App produz
• Mantenha visualmente claro
• Formato quadrado ou 4:3 costuma funcionar melhor

Etapa 6: revise e salve

Antes de salvar

Verifique se:

• ✅ O nome é claro e descritivo
• ✅ A descrição explica o que o App faz
• ✅ Todos os inputs necessários estão expostos
• ✅ Labels são amigáveis
• ✅ Campos obrigatórios estão marcados corretamente
• ✅ A thumbnail representa o App

Salve o App

Clique em Save ou Create App.

Seu App agora está pronto para usar!

Etapa 7: teste seu App

Faça um teste

1. Vá para a seção Apps
2. Encontre seu novo App
3. Preencha os inputs
4. Clique em Generate
5. Verifique o output

Verifique a experiência

Pergunte a si mesmo:

• Está claro o que inserir?
• O output corresponde ao esperado?
• Há algo confuso?

Editando seu App

Acessando o modo de edição

1. Vá para a seção Apps
2. Encontre seu App
3. Clique no botão Edit ou Settings

O que você pode mudar

• Nome e descrição do App
• Quais inputs são expostos
• Labels e obrigatoriedade dos inputs
• Thumbnail

O que você não pode mudar

• O workflow por trás (edite no Canvas)
• Configurações dos nodes (edite no Canvas)

Atualizando o workflow

Se você precisar mudar o workflow:

1. Abra o Canvas original
2. Faça as mudanças
3. Reabra o App Builder
4. Atualize a configuração do App, se necessário

Boas práticas

Mantenha simples

• Exponha apenas inputs essenciais
• Não sobrecarregue usuários com opções
• Oculte a complexidade nos bastidores

Escreva labels claros

• Use linguagem simples
• Descreva o que é necessário
• Inclua exemplos, se ajudar

Teste bem

• Execute o App várias vezes
• Tente inputs diferentes
• Verifique a qualidade do output

Pense nos usuários

• Quem vai usar este App?
• O que eles precisam saber?
• O que pode confundir?

Erros comuns

❌ Expor inputs demais

Problema: usuários ficam sobrecarregados com opções.

Solução: exponha apenas o que é realmente necessário. Deixe configurações avançadas ocultas.

❌ Labels pouco claros

Problema: usuários não sabem o que inserir.

Solução: escreva labels descritivos e adicione descrições úteis.

❌ Não testar

Problema: o App não funciona como esperado.

Solução: sempre teste com diferentes inputs antes de compartilhar.

❌ Esquecer campos obrigatórios

Problema: usuários enviam inputs incompletos.

Solução: marque inputs essenciais como obrigatórios.

Exemplo: configuração completa de App

Product Photo Generator

Nome: Product Photo Generator

Descrição: Create professional product photos with custom backgrounds. Upload your product image and describe your ideal setting.

Inputs:

Thumbnail: Exemplo de output mostrando um produto sobre mármore

Próximos passos

• Running Apps — Aprenda a usar seus Apps
• App Ideas for Creatives — Inspire-se
• Multi-Step Workflows — Crie Apps mais complexos