> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Padrões de aplicativos

> Qual formato de aplicativo Kazzle usar para tarefas comuns.

# Padrões de aplicativos

Escolha o menor formato de aplicativo que se adeque à tarefa. Adicione um processo, banco de dados, sincronização ou API de IA apenas quando o aplicativo precisar dessa funcionalidade.

| O usuário quer                                                    | Use                            | Notas                                                                                                                                             |
| ----------------------------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Página de destino, relatório, página estática                     | Aplicativo de UI               | Um componente de UI é suficiente.                                                                                                                 |
| Painel ou ferramenta interna com dados do servidor                | UI + processo                  | Mantenha rotas de API e credenciais no componente de processo.                                                                                    |
| Dados persistentes do aplicativo                                  | UI + processo + banco de dados | Reutilize um banco de dados ativo adequado antes de criar um.                                                                                     |
| Dados offline ou síncronos instantâneos em múltiplos dispositivos | Aplicativo em tempo real       | Ative a sincronização e verifique `sync: ready` antes de conectar o aplicativo.                                                                   |
| Tarefa agendada ou webhook                                        | Aplicativo de processo         | Use acionadores em um componente de processo.                                                                                                     |
| Recurso alimentado por IA dentro de um aplicativo                 | Processo + API de IA Kazzle    | Use `/ai/*` com uma chave de API `kzl_`.                                                                                                          |
| Ferramenta que o assistente deve chamar depois                    | Skill + processo               | Adicione uma pasta de skill (`SKILL.md` + `tools.ts`) e respaldar cada ferramenta `target.type: 'app'` com uma rota em um componente de processo. |

## Padrões

* Comece a partir de um modelo quando um se adequar.
* Mantenha o código frontend livre de segredos e URLs de banco de dados.
* Coloque o trabalho apenas do servidor em um componente de processo.
* Use URLs de componentes irmãos em vez de endereços localhost codificados.
* Verifique visualizações na aba app-dev antes de dizer que o aplicativo está em execução.