> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Empacote e publique

Gere instaladores e mantenha as evidências de release separadas do sucesso do build.

## Passo a passo para iniciantes

Pré-requisitos: Conclua a configuração local do Desktop, incluindo Rust e as ferramentas de construção do sistema operacional. Pare o processo de desenvolvimento do Tauri antes de construir um instalador; deixe o back-end da Web em execução. Execute cada verificação abaixo na raiz do repositório e espere que ela termine antes de executar a próxima. Os comandos do pacote filtrado funcionam em checkouts somente para desktop e todas as plataformas.

Termos rápidos: um espaço de trabalho consiste em usuários, dados e configurações separados de uma equipe. O servidor é o back-end confiável; mantenha as chaves do provedor fora do navegador e do código do telefone. Uma migração é uma alteração de versão do banco de dados que cria ou atualiza tabelas. Um modelo de IA é o mecanismo que responde; o catálogo de modelos é a lista do servidor de IDs e preços de modelos disponíveis. Um provedor é um serviço externo, como IA, e-mail ou serviço de cobrança. Um direito é uma concessão que permite que um espaço de trabalho use um recurso. Um webhook é uma mensagem que um serviço envia para o URL de outro serviço.

1. Em uma filial local, peça ao seu agente de codificação para inspecionar `apps/desktop/src-tauri/tauri.conf.json` e definir o identificador do produto, o nome do aplicativo, os ícones e o back-end URL com os valores que você possui. Use um back-end HTTPS público URL para compilações de lançamento.

2. Na raiz do repositório, execute as verificações do pacote Desktop abaixo. Antes de check:release-config, defina SUPASTACK_APP_URL neste terminal usando o comando do sistema operacional na configuração local do desktop; o back-end público HTTPS deve estar em execução e o identificador do aplicativo deve ser seu.

3. Uma compilação bem-sucedida não assina, autentica ou publica um instalador; se Rust ou uma biblioteca do sistema estiver faltando, conclua a configuração local do Desktop.

Para código personalizado, comece com o `prompts/README.md` fornecido e copie o prompt mais próximo: `prompts/new-app-screen.md` para uma tela de aplicativo ou `prompts/new-landing-page.md` para uma página pública. Para trabalho de servidor, banco de dados ou provedor, dê ao seu agente de codificação a tarefa deste guia e peça-lhe para ler `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` e espelhos `.ai/` correspondentes; inspecione os arquivos de origem exatos nomeados aqui; listar arquivos e verificações antes de editar; preservar a propriedade do espaço de trabalho e os segredos apenas do servidor; e mostrar a diferença. Informe o comportamento desejado, campos de entrada e saída, funções permitidas, sucessos e erros esperados e a conta de teste, provedor ou dispositivo. Use valores de amostra; nunca cole um segredo real.

[Antes de começar](https://supastack.dev/pt/docs/web/before-you-start.md)

[Noções básicas sobre terminais](https://supastack.dev/pt/docs/web/terminal-basics.md)

[Configuração local do desktop](https://supastack.dev/pt/docs/desktop/ship-in-5-minutes.md)

[Avisos do agente e memória do projeto](https://supastack.dev/pt/docs/web/agents.md)

```
corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build
```


## Configurar o shell do produto

Revise `src-tauri/tauri.conf.json`, metadados de carga, recursos e identificadores de plataforma. Substitua os ícones do aplicativo por meio do processo de ativos compartilhados e defina o back-end pretendido URL em tempo de construção/execução. O aplicativo web hospedado já deve estar implantado e acessível.


## Execute o portão de construção nativo

Esses comandos de pacote executam verificações e testes de tipo Rust, validam as configurações de versão e criam o instalador Tauri. A configuração de assinatura e distribuição depende da plataforma de destino e de sua conta/certificados; não armazene material de assinatura na fonte.

```
corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build
```


## Verifique o instalador no sistema operacional de destino

Verifique instalação limpa, inicialização, acessibilidade de back-end, autenticação, menus/bandeja, registro de teclas de atalho, segunda instância, links diretos, nova tentativa offline e desinstalação. Verifique cada sistema operacional compatível separadamente. Uma construção local não comprova distribuição comercial assinada ou autenticada; configuração de assinatura, feed de atualização e automação de lançamento não estão incluídos.

[Lista de verificação de aceitação nativa](https://supastack.dev/pt/docs/desktop/run.md)

[Implante o back-end compartilhado](https://supastack.dev/pt/docs/web/deployment.md)


## Instalação e configuração

Execute corepack pnpm --filter @supastack/desktop check:release-config antes de preparar um instalador. Ele verifica se SUPASTACK_APP_URL é HTTPS sem credencial em um host público e se o identificador Tauri é específico do produto; a verificação é opcional e não bloqueia o desenvolvimento local.

corepack pnpm --filter @supastack/desktop build executa tauri build. Os destinos do pacote em tauri.conf.json produzem os formatos de instalação disponíveis no sistema operacional host – construídos em cada sistema operacional enviado. Artefatos pousam sob apps/desktop/src-tauri/target/release/bundle/.

productName, versão e identificador estão em tauri.conf.json – coloque a versão lá antes de lançar um lançamento. Regenere ícones com corepack pnpm --filter @supastack/desktop icons, que reescreve src-tauri/icons de icon-source.png.

```
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop icons
corepack pnpm --filter @supastack/desktop build
# artifacts: apps/desktop/src-tauri/target/release/bundle/
```


## Fluxo de implementação

Builds sem assinatura podem ser instalados localmente, mas exibem avisos de confiança do sistema operacional. Assinatura de código e notarização da Apple fazem parte da sua configuração de release; guarde os certificados em um gerenciador de segredos dedicado, nunca no repositório.

Inclua a URL de produção SUPASTACK_APP_URL nos builds de release para que o shell instalado carregue o app web publicado, em vez de localhost.


## Verificação e resolução de problemas

Instale o bundle gerado em cada sistema operacional-alvo e registre o build, o sistema e a URL do app usados na aceitação. Verifique inicialização, implantação carregada, bandeja, atalho e persistência do login após reiniciar; concluir tauri build não é evidência suficiente de release.


Para continuar a configuração, leia [Assinatura de código](https://supastack.dev/pt/docs/desktop/signing.md).


## Seguinte

[Assinatura de código](https://supastack.dev/pt/docs/desktop/signing.md)
