# Apps (miniapps)

> Um miniapp é um workflow publicado como formulário simples, com URL própria. Escolha as entradas, os layouts, o compartilhamento, o preço e a incorporação.

Source: https://nodaro.ai/pt-BR/docs/concepts/apps

Um **miniapp** é um workflow publicado como um app simples. As pessoas preenchem um formulário curto, clicam em **Iniciar**, e o Nodaro executa o workflow por trás dele e mostra os resultados. Elas nunca veem o canvas, e cada miniapp tem a própria URL, o próprio histórico de execuções e versões.

## Como funciona um miniapp
| | Você, o criador | As pessoas que executam o app |
| --- | --- | --- |
| **O que vê** | O workflow inteiro no canvas | Só as entradas e os resultados que você escolheu |
| **O que faz** | Monta o workflow, escolhe as entradas e as saídas e publica | Preenche as entradas e clica em **Iniciar** |
| **Quanto custa** | Nada para publicar | Os créditos da execução, do próprio saldo, mostrados no botão **Iniciar** |

Workflow: O app mostra duas entradas e uma saída. Tudo o que fica entre elas é executado por trás do formulário.

- Texto → Gerar imagem (prompt)
- Estilo → Gerar imagem (look)
- Gerar imagem → Gerar vídeo (quadro inicial)

## Publicar um workflow como miniapp
### Abrir a aba Apresentar
Abra o workflow e clique em **Apresentar** no topo do editor. Na aba Apresentar, você monta o que as pessoas veem: as entradas que elas preenchem, os resultados que recebem e os títulos, grupos e textos curtos em volta deles.

### Escolher as entradas e as saídas
Adicione os nós cujos campos as pessoas devem preencher, como um prompt, um envio de imagem ou um seletor. Depois, adicione os nós cujos resultados elas devem ver. Dê a cada um um título e uma descrição. Em uma lista de opções, você pode restringir os valores que as pessoas podem escolher.

### Clicar em Publicar e escolher Miniapp
Clique em **Publicar**, escolha **Miniapp** e insira um **Nome do miniapp** e uma descrição. O **Slug da URL** é opcional; deixe-o em branco, e o Nodaro cria um a partir do nome.

### Definir as opções do app e publicar
Escolha as opções da tabela abaixo e clique em **Publicar app**. Use **Abrir miniapp** para vê-lo como os seus usuários vão ver.

| Opção | O que faz |
| --- | --- |
| **Listar no marketplace** | Lista o app na aba **Explorar** da página **Miniapps**, com a categoria, os tipos de saída e as tags que você escolher. Um app não listado continua abrindo pelo link. |
| **Aceita RemX** | Permite que as pessoas personalizem e remixem o seu app. |
| **Somente leitura** | As pessoas veem os resultados, mas não podem editar as entradas. |
| **Modos de visualização permitidos** | Os layouts entre os quais as pessoas podem alternar. Veja [Modos de visualização](#view-modes). |
| **Modo de visualização padrão** | O layout em que o app abre. |
| **Padrões da comparação** | Os dois nós que o modo **Comparar lado a lado** mostra no início, à esquerda e à direita. |
| **Miniatura da execução** | O nó cujo resultado é a miniatura de cada execução na lista de execuções. |

O app publicado fica em `app.nodaro.ai/app/` seguido do slug. A URL continua a mesma entre as versões. Publique de novo depois de alterar o workflow, e todos os links compartilhados abrem a nova versão.

## Modos de visualização
Quem cria o app escolhe quais modos de visualização ele oferece e em qual deles ele abre. Quem executa o app pode alternar entre os modos permitidos.

| Modo | Como é |
| --- | --- |
| **Divisão horizontal** | Entradas à esquerda, resultados à direita. |
| **Pilha vertical** | Entradas em cima, resultados embaixo. Bom para telas estreitas. |
| **Grade de galeria** | Entradas e resultados como uma grade de cartões. |
| **Slides em tela cheia** | Um resultado por vez, em tela cheia. |
| **Comparar lado a lado** | Dois resultados um ao lado do outro. |
| **Chat** | Uma barra de entradas na parte de baixo reúne as entradas, e cada execução aparece como uma mensagem em uma conversa. |

### Modo chat
O modo chat transforma um app em uma conversa. Ele fica desativado até você adicionar **Chat** aos modos de visualização permitidos do app e funciona no computador e no celular.

- **A barra de entradas é uma fileira de chips.** Cada entrada é um pequeno chip: clique nele para editar o valor. Um chip de envio mostra uma miniatura depois que você adiciona um arquivo.
- **Iniciar executa o app.** Não há um botão separado de nova execução. **Iniciar** começa uma execução, mostra o preço em créditos e mantém os seus valores na barra de entradas, para que você possa mudar um deles e executar de novo.
- **Uma execução por vez.** A barra de entradas fica bloqueada enquanto uma execução está em andamento e é liberada quando ela termina.
- **Cada execução fica na conversa.** Uma execução com várias etapas mostra um chip para cada etapa, que é marcado quando a etapa termina. Use **Reutilizar entradas** para executar de novo com os mesmos valores, **Ver etapas** para abrir o resultado de uma etapa ou **Baixar** para salvar um resultado.
- **Resultados em tela cheia.** Toque em um resultado para abri-lo em tela cheia. Use ← e → para percorrer as entradas e os resultados daquela execução, ↑ e ↓ para passar de uma execução para outra e Esc para fechar.

## O que as pessoas que executam o seu app veem
- **Só o que você escolheu.** As entradas e os resultados que você colocou na aba Apresentar, com os seus títulos e textos.
- **Não o seu texto antes e depois.** O [texto antes e depois](https://nodaro.ai/docs/concepts/prompt-pre-post-text) de um nó envolve todo prompt, mas nunca aparece no app. Use-o para o seu estilo padrão.
- **Não os seus destinos.** O app fixa para onde envia e o que busca: o endereço de uma [**Saída de webhook** (Webhook Output)](https://nodaro.ai/docs/nodes/publish/webhook-output), uma conta de rede social ou o alvo de um scraper. Quem executa o app não pode alterá-los.
- **O próprio saldo.** As pessoas precisam fazer login para executar um app, e cada execução é paga com os créditos delas. O app informa quantas execuções o saldo delas cobre.

Uma **Saída de webhook** que envia com uma chave salva precisa usar uma chave vinculada a um único endereço antes que você possa publicar o app. A caixa de diálogo de publicação oferece fazer esse vínculo para você. Veja [Saída de webhook](https://nodaro.ai/docs/nodes/publish/webhook-output).

## Compartilhar um link de apresentação, sem publicar
A aba Apresentar também pode compartilhar o workflow sem publicá-lo. A caixa de diálogo de compartilhamento cria um link que qualquer pessoa pode usar para executar o workflow, pagando com os próprios créditos. As **Configurações de visualização** dela incluem **Quem acessa só pode ver os resultados**, os modos de visualização permitidos e o modo de visualização padrão. **Revogar compartilhamento** desativa o link.

Publique um miniapp quando quiser uma URL permanente, histórico de execuções, versões, análises e um lugar na página Miniapps. Use um link de compartilhamento para uma revisão rápida.

## Gerenciar seus miniapps
Abra **Miniapps** na barra lateral. A página tem três abas:

- **Explorar**: todos os miniapps listados. Pesquise e ordene por **Mais populares**, **Mais recentes** ou **Mais favoritados**.
- **Meus miniapps**: os apps que você publicou, com as execuções, o preço por execução e os favoritos de cada um. Em cada cartão, você pode abrir o app ou o workflow dele e copiar a URL ou o código de incorporação. Você também pode ver as **Análises** do app, editar as configurações, listá-lo ou deixar de listá-lo e desativá-lo.
- **Favoritos**: os apps que você marcou com o coração.

Excluir um miniapp o oculta do marketplace e da sua lista. Você pode restaurá-lo a qualquer momento em **Miniapps excluídos**, e os ganhos, as análises e o histórico de execuções dele são mantidos.

## Cobrar pelo seu miniapp
No Nodaro Cloud, você pode cobrar um acréscimo quando outras pessoas executam o seu miniapp. Abra **Editar configurações do miniapp** no cartão do app e, em **Monetização**, defina uma taxa fixa em créditos, uma porcentagem ou as duas. A caixa de diálogo mostra quanto as pessoas vão pagar: o custo base da execução mais o seu acréscimo. **Padrões de monetização**, na página Miniapps, define a taxa e a porcentagem que um miniapp recebe quando você ativa a monetização dele pela primeira vez.

Os seus ganhos são adicionados ao seu saldo de recarga e valem por 12 meses. A página **Cobrança** mostra os ganhos em **Ganhos com miniapps**, para este mês, os últimos 30 dias e todo o período. Veja [Créditos](https://nodaro.ai/docs/concepts/credits).

## Incorporar um miniapp ou executá-lo por código
**Incorpore em um site.** Clique em **Incorporar** no cartão do app para copiar o código de incorporação. Antes, adicione os sites que podem exibir o app em **Configurações de incorporação** › **Domínios permitidos para incorporação**. A incorporação fica bloqueada até você adicionar pelo menos um domínio.

**Execute pelo seu próprio código.** O seu site ou app também pode executar um miniapp publicado pela API REST. O seu servidor lê as entradas do app, inicia uma execução e espera o resultado. O identificador do app é o slug dele, a última parte da URL. As execuções são assíncronas, então o seu servidor inicia uma execução e depois verifica o resultado. O fluxo completo, com código, está em [Incorporar um miniapp](https://nodaro.ai/docs/developers/embed/miniapps).

Os assistentes conectados via [MCP](https://nodaro.ai/docs/mcp) também podem listar e executar os seus apps, e a [CLI](https://nodaro.ai/docs/developers/cli) executa um app com `nodaro apps run`.

Para reutilizar um workflow dentro de outros workflows, e não como formulário, publique-o como [componente](https://nodaro.ai/docs/concepts/components-and-sub-workflows). Um workflow pode ser publicado tanto como miniapp quanto como componente.

## Frequently asked questions

### O que é um miniapp no Nodaro?

Um miniapp é um workflow publicado como um app simples, com URL própria. As pessoas preenchem as entradas que você escolheu e clicam em “Iniciar”. O Nodaro executa o workflow e mostra os resultados, sem o canvas.

### Quem paga pelas execuções do meu miniapp?

Quem executa o app paga com os próprios créditos, e o botão “Iniciar” mostra o preço antes. No Nodaro Cloud, você também pode adicionar um acréscimo, que entra no seu saldo de recarga como ganho.

### As pessoas veem meus prompts e minhas configurações?

Elas veem só as entradas e os resultados que você colocou no app. O seu texto antes e depois nunca aparece para elas, e os destinos dos nós que enviam dados para fora, como o endereço de um webhook ou uma conta de rede social, não podem ser alterados por quem executa o app.

### Como atualizo um miniapp publicado?

Altere o workflow e publique-o de novo pela aba “Apresentar”. A URL continua a mesma entre as versões, então os links que você já compartilhou continuam funcionando.

### Posso colocar um miniapp no meu site?

Sim. Copie o código de incorporação no cartão do app e adicione o seu site em “Domínios permitidos para incorporação”. Para criar a sua própria interface, o seu servidor pode iniciar execuções e ler os resultados pela API REST.