For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /pt/docs/desktop.md (or send Accept: text/markdown).

Visão geral do desktop

Um shell webview Tauri à volta da mesma app web — presença, não um segundo produto.

Perguntar sobre este guia

Passo a passo para iniciantes

Pré-requisitos: Leia os dois guias para iniciantes abaixo e conclua a configuração local do Desktop, incluindo Rust e pré-requisitos do sistema operacional. O bloco de código inicia o aplicativo da web e Tauri no monorepo; em uma finalização de compra somente para desktop, use seu comando filtrado somente após iniciar um back-end da web acessível separadamente. Tauri carrega esse backend.

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. Siga a configuração local do Desktop, abra o aplicativo na janela Tauri e faça login na mesma conta da web que você usa em um navegador.

2. Visite uma página da área de trabalho, oculte/mostre a janela da bandeja e tente o atalho de convocação.

3. A tela deve corresponder ao aplicativo da web porque Tauri carrega o backend configurado. Se estiver em branco, confirme se SUPASTACK_APP_URL aponta para um aplicativo da web em execução acessível.

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.

# Monorepo: start the web app and desktop shell together
corepack pnpm dev:desktop

# Desktop-only checkout: start Tauri after a web backend is already reachable
corepack pnpm --filter @supastack/desktop dev

Uma UI de produto, um shell nativo

apps/desktop é uma visualização da web Tauri em seu aplicativo da web. Ele compartilha UI do produto, autenticação e chat com a web; o comportamento nativo da janela/bandeja reside em src-tauri/src/lib.rs. Ele precisa de um back-end da web acessível e não inclui uma interface de produto independente.

Use os recursos nativos do shell

O shell vem com um menu de bandeja, próximo à bandeja, foco de instância única, tecla de atalho de convocação global, menus de navegação/visualização nativos, links externos no navegador do sistema, convocação de link direto supastack://, estado de janela lembrado e uma sobreposição de nova tentativa offline.

SUPASTACK_APP_URL escolhe o backend: valor válido em tempo de execução, depois valor de compilação e por fim localhost. SUPASTACK_DESKTOP_HOTKEY substitui CmdOrCtrl+Shift+Space. As compilações de lançamento assinadas injetam SUPASTACK_UPDATER_ENDPOINT e SUPASTACK_UPDATER_PUBKEY; quando o caminho do endpoint contém {{channel}}, o menu do aplicativo habilita Beta Updates (stable vs beta, substituível em tempo de execução com SUPASTACK_UPDATE_CHANNEL).

Escolha o caminho da sua área de trabalho

Execute a Web e o desktop juntos para trabalho local e, em seguida, crie e verifique o destino nativo com seus pré-requisitos de plataforma. A assinatura da loja, os instaladores e o comportamento da área de trabalho física exigem aceitação separada.

Um shell webview, não uma segunda app

apps/desktop é um shell Tauri 2.x. O núcleo Rust em src-tauri detém a janela, a bandeja do sistema e o atalho global, enquanto uma webview carrega a aplicação web. Interface, autenticação, faturação e AI vêm do mesmo código Next.js — a superfície desktop acrescenta presença, não um produto paralelo.

O shell inclui uma página provisória em apps/desktop/ui mostrada enquanto a app web carrega, para que um arranque a frio nunca mostre uma janela vazia.

Aponta o shell para um deployment

O destino da janela resolve-se por ordem: SUPASTACK_APP_URL em runtime, depois SUPASTACK_APP_URL em compile-time, depois http://localhost:3000. Só URLs http e https são aceites — valores vazios ou não-web caem no candidato seguinte.

Para desenvolvimento, isso significa que o shell é anexado a qualquer corepack pnpm dev que serve. Para produção, defina a variável no momento da construção para incorporar seu aplicativo Web implantado.

Os segredos ficam no servidor

O shell não transporta credenciais de fornecedores. A webview fala com a mesma superfície de API autenticada que um browser usa — chaves de fornecedor, segredos de sessão e configuração de faturação ficam no servidor.

O identificador de bundle com.supastack.desktop e o conjunto de capabilities por defeito (core:default) mantêm a webview em sandbox; alarga permissões em src-tauri/capabilities só quando uma funcionalidade nativa o exigir.

Para continuar a configuração, leia Execute e configure o shell.