Guia do desenvolvedor

Publique suas apps com IA

Três caminhos para colocar sua solução no catálogo — do formulário simples a deixar a sua própria IA publicar por você. Com exemplos de prompts prontos para copiar.

Três caminhos

Como publicar

Escolha o que combina com você.

Caminho 1

Pelo formulário

O jeito direto: faça login, clique em Publicar e preencha. Ótimo para links e arquivos (download).

recomendado

Caminho 2

Pela sua IA (MCP)

O jeito nativo: conecte seu assistente via MCP e peça para ele publicar. Ele cria, envia o build e publica.

Caminho 3

Pela API (REST)

Para automações e scripts: chamadas HTTP autenticadas por token Bearer. Mesma base que o MCP usa.

Copiar e colar

Exemplos de prompts

Com o MCP conectado, é só pedir em linguagem natural. Troque o que está entre colchetes.

Criar um app do zero e publicar

Crie um app web de [lista de tarefas com prioridades] em um único index.html
(HTML + CSS + JS, tema escuro, responsivo). Depois publique no meu Studio Aura
como app hospedado, com:
- título: [Minhas Tarefas]
- resumo: [Organize suas tarefas com prioridades, direto no navegador]
- categoria: [Produtividade]
Deixe publicado.

Publicar um app que eu já tenho

Aqui está o código do meu app (vou colar abaixo / está em anexo).
Publique no meu Studio Aura como app hospedado com título "[Meu App]",
resumo "[uma frase]" e categoria "[Utilidades]". Pode deixar como rascunho
por enquanto, que eu reviso antes de publicar.

Publicar um link (app que roda em outro lugar)

Publique no meu Studio Aura um LINK para o meu app que já roda em
https://[meuapp.vercel.app], com título "[Meu SaaS]", resumo "[o que faz]"
e categoria "[Negócios]". Deixe publicado.

Atualizar um app já publicado

Atualize o app "[slug-do-meu-app]" no meu Studio Aura: [troque a cor de
destaque para azul e adicione um botão de limpar tudo]. Reenvie o build.

Gerenciar minhas soluções

Liste as minhas soluções no Studio Aura com o status de cada uma.
Depois despublique a "[slug-do-app]" (volte para rascunho).

Dica: quanto mais específico o pedido (título, categoria, o que o app faz), melhor o resultado.

Conector

Configurar o MCP

Na alpha, o conector roda localmente.

1
Gere um token
Acesse /conta/tokens e crie um token. Ele aparece uma única vez — copie e guarde.
2
Prepare o conector
Peça o pacote studio-aura-mcp ao administrador e rode:
```
cd studio-aura-mcp
npm install
npm run build
```

Conecte no seu cliente de IA

No arquivo de configuração MCP (ex.: Claude Desktop):

{
  "mcpServers": {
    "studio-aura": {
      "command": "node",
      "args": ["/caminho/para/studio-aura-mcp/dist/index.js"],
      "env": { "STUDIO_AURA_TOKEN": "sa_..." }
    }
  }
}

4
Peça para publicar
Pronto. Use um dos prompts de exemplo e deixe a IA fazer o resto.

Ferramentas que a IA ganha

publicar_app_webcria um app hospedado e envia os arquivos (HTML/CSS/JS).
publicar_linkpublica um link para um app externo.
enviar_build_webatualiza os arquivos de um app já existente.
definir_statuspublica ou volta para rascunho.
listar_minhas_solucoeslista o que você já tem.

App hospedado

Requisitos do app web

Pode / precisa

Um index.html na raiz (página de entrada).
HTML, CSS e JS — vários arquivos, com caminhos relativos.
localStorage, canvas, libs via CDN (<script src>).
Chamadas a APIs públicas externas (fetch).

Não dá (por enquanto)

Backend próprio / servidor (o app roda no navegador).
Banco de dados no servidor — use localStorage ou API externa.
Processos Node/Python rodando no Studio Aura.
Caminhos absolutos (use relativos: `./style.css`).

Precisa de backend de verdade? Hospede onde quiser e publique como link externo — você ganha vitrine no catálogo do mesmo jeito.

Para automações

Referência da API

Base: https://studioaurabrasil.com.br · Autenticação: header Authorization: Bearer sa_...

POST/api/v1/solucoes

Cria uma solução (JSON). Campos: title, summary, description, type (link|web), externalUrl?, category?, tags?, status?.

POST/api/v1/solucoes/:slug/build

Envia o build de um app web: { "files": { "index.html": "..." } }. Marca como type=web.

POST/api/v1/solucoes/:slug/status

{ "status": "published" | "draft" }.

GET/api/v1/solucoes

Lista as suas soluções.

Exemplo (curl)

# 1) criar (app web)
curl -X POST https://studioaurabrasil.com.br/api/v1/solucoes \
  -H "Authorization: Bearer sa_..." -H "Content-Type: application/json" \
  -d '{"title":"Meu App","summary":"...","description":"...","type":"web","category":"Utilidades"}'

# 2) enviar o build (use o "slug" devolvido acima)
curl -X POST https://studioaurabrasil.com.br/api/v1/solucoes/meu-app/build \
  -H "Authorization: Bearer sa_..." -H "Content-Type: application/json" \
  -d '{"files":{"index.html":"<!doctype html><h1>Oi</h1>"}}'

# 3) publicar
curl -X POST https://studioaurabrasil.com.br/api/v1/solucoes/meu-app/status \
  -H "Authorization: Bearer sa_..." -H "Content-Type: application/json" \
  -d '{"status":"published"}'

Dúvidas técnicas

FAQ do desenvolvedor

Meu app pode ter várias páginas?+

Pode. Envie vários arquivos (ex.: index.html, sobre.html, app.js) e use links relativos. A entrada é sempre o index.html.

Posso usar bibliotecas (React, Tailwind, etc.)?+

Sim, via CDN (<script>/<link>) ou já “buildadas” em arquivos estáticos. O importante é que rode no navegador, sem servidor.

Como guardo dados dos usuários?+

No app hospedado, use localStorage (no navegador de cada pessoa). Para dados no servidor, hospede um backend próprio e publique como link externo.

Como atualizo um app já publicado?+

Reenvie o build para o mesmo slug (ferramenta enviar_build_web no MCP, ou POST /api/v1/solucoes/:slug/build). Substitui o anterior.

Tem algum limite?+

Na alpha: até 200 arquivos por build, e arquivos são enviados como texto (UTF-8). Apps estáticos típicos cabem com folga.

Bora publicar

Gere seu token, conecte sua IA e coloque sua primeira app no ar.