ttheo.
Voltar

Primeiros passos

Criando seu primeiro app

Criando seu primeiro app

⚠️ Antes de começar: escolha o caminho certo

O theo tem 2 modos de criação, e errar no início custa retrabalho.

Se seu app é simples (1-2 telas, 1-2 entidades)

Use o app único. Continue lendo este guia.

Se seu app é um sistema (CRM, ERP, gestão, plataforma)

Use o Wizard de Sistema Modular em vez deste guia. → Quando usar Sistema Modular → Acesso direto: Dashboard → link "Sistema modular →"

Em dúvida? Se a palavra "sistema", "plataforma" ou "gestão" aparece no nome do projeto, é modular.

Criando seu primeiro app único

1. Abre o Dashboard

A barra lateral tem o atalho [🎯 Criar com IA] em destaque. Click leva pro /creator.

2. Escolha o modo

Você vai cair numa tela com 2 cards lado a lado:

📋 Gerar prompt pra IA externa (GRATIS)

  • Você descreve, a plataforma monta um prompt grande e detalhado
  • Você cola no ChatGPT, Claude.ai ou Gemini
  • A IA externa gera o código
  • Você cola o código de volta na plataforma e vê o preview

✨ Gerar com IA interna (chat)

  • Chat direto na plataforma
  • Você descreve, a IA gera ao vivo
  • Pague direto na Anthropic (~USD 0,05–0,40 por app gerado)
  • Precisa cadastrar sua API key em /settings?tab=api

3. Descreva o app

Quanto mais específico, melhor. Mencione:

  • Entidade: o que o app vai armazenar (clientes, tarefas, produtos...)
  • Campos: que dados de cada um (nome, email, status, valor...)
  • Fluxos: cadastrar, listar, editar, deletar, exportar, etc
  • UI: tabela, kanban, dashboard, formulário...

Exemplo bom:

"App pra controlar consultas da minha clínica. Cada consulta tem: paciente (texto), data, valor (decimal), status (agendada/realizada/cancelada). Lista com filtro por status, total faturado por mês, formulário pra cadastrar."

Exemplo ruim (vago, vai gerar app genérico):

"Sistema de consultas"

4. Espera gerar

  • IA interna: 30s-2min, vê tudo ao vivo no preview
  • IA externa: você é responsável pelo tempo (depende da IA escolhida)

5. Edita conversando

Depois que o app aparece no preview, vai aparecer um chat à esquerda. Peça mudanças em português:

  • "Adiciona um campo 'observações'"
  • "Muda a cor pra azul"
  • "Adiciona um botão de exportar pra Excel"

A IA modifica o código sem você precisar entender programação.

6. Salva

Salvar no canto superior direito. Escolhe nome, ícone, cor, visibilidade.

E quando o app crescer demais?

Se você começou com app único e percebeu que tá ficando grande (>2000 linhas, IA começa a cortar código), migre pra Sistema Modular:

  1. Anote as entidades atuais
  2. Use o Wizard pra recriar a estrutura
  3. Peça pra IA migrar os dados (INSERT INTO new SELECT FROM old)

Detalhes em Sub-apps e Sistemas Modulares.

Próximos passos