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/ship-in-5-minutes.md (or send Accept: text/markdown).
Inicie o app desktop em 5 minutos
Prepare o Rust e as ferramentas de construção do seu sistema operacional, inicie um back-end da Web acessível, abra a janela Tauri e verifique o comportamento da bandeja, do atalho e da tarefa local.
1. Instale as ferramentas gerais e nativas
Concluir Antes de começar, clone seu repositório Desktop ou monorepo Todas as plataformas e abra-o no editor. A área de trabalho é uma janela nativa do mesmo aplicativo da Web. Não inclui uma segunda implementação de contas ou chat. O lançamento de cinco minutos começa após a instalação das dependências e ferramentas nativas; a instalação inicial e a compilação do Rust geralmente demoram mais.
No Windows, instale o Microsoft C++ Build Tools usando o link de pré-requisitos Tauri abaixo. Em seu instalador selecione Desenvolvimento Desktop com C++, mantenha o Windows SDK selecionado e conclua a instalação. Certifique-se de que o tempo de execução do Microsoft Edge WebView2 esteja instalado. Instale o Rust de Rustup.rs usando Rustup-init.exe; mantenha o conjunto de ferramentas MSVC padrão. Reabra seu terminal após a instalação.
No macOS, execute xcode-select --install no Terminal e preencha a caixa de diálogo das ferramentas de linha de comando se elas não estiverem instaladas. Instale o Rust usando o comando macOS de rustup.rs. No Linux, siga a página de pré-requisitos Tauri para os pacotes WebKitGTK, compilador, bandeja e biblioteca do sistema da sua distribuição exata e, em seguida, instale o Rust. Os nomes dos pacotes Linux variam; não execute comandos de outra distribuição.
Abra um terminal na raiz do repositório e execute as verificações de versão abaixo. Tanto rustc quanto cargo devem imprimir versões; cargo é a ferramenta de construção do Rust. Se algum deles estiver faltando, conclua a instalação e reabra o terminal antes de continuar.
- Instale as ferramentas e obtenha o código
- Aprenda como executar um comando e editar um arquivo
- Lista de verificação de pré-requisitos do sistema operacional de Tauri
- Instalador oficial do Rust
rustc --version
cargo --version
corepack pnpm install2. Inicie ou escolha o back-end da Web
Se o seu checkout contém apps/web, siga o tutorial Web, crie apps/web/.env.local, execute o servidor Web em um terminal separado usando o comando abaixo e deixe-o rodando. Primeiro verifique http://localhost:3000 em seu navegador. Você pode usar a demonstração /dashboard sem banco de dados; o login real em /auth precisa ser migrado para Postgres.
Uma finalização de compra somente para desktop não contém apps/web. Use o back-end da Web executado separadamente fornecido para o seu produto e abra seu URL em seu navegador para confirmar se funciona. O shell da área de trabalho não pode criar o back-end para você. Não tente o comando da Web abaixo se essa pasta estiver ausente. A Etapa 3 mostra como escolher um endereço de back-end fornecido.
# Only when this checkout contains apps/web:
corepack pnpm --filter @supastack/web dev3. Inicie a janela da área de trabalho
Abra um segundo terminal na raiz do repositório enquanto o backend continua em execução. Para o back-end local padrão em http://localhost:3000,, execute o primeiro comando abaixo. Cargo pode baixar bibliotecas e compilar o shell; espere a janela do Supastack abrir. São esperadas mensagens do compilador durante a primeira construção.
Para um back-end fornecido, substitua https://app.example.com no bloco apropriado do sistema operacional abaixo pelo seu URL real. Execute apenas o bloco da sua plataforma. SUPASTACK_APP_URL é uma configuração de ambiente de terminal, lida quando o processo nativo é iniciado. Colocá-lo apenas em root .env não configurará o shell. Mantenha o back-end URL livre de nomes de usuário ou senhas incorporados.
No monorepo Todas as plataformas, o corepack pnpm dev:desktop pode iniciar Web e Tauri juntos quando pnpm estiver em PATH conforme explicado em Antes de começar. O comando filtrado abaixo também funciona em checkouts somente para desktop, com o backend sendo executado separadamente.
# Default local backend (all operating systems):
corepack pnpm --filter @supastack/desktop dev
# Custom backend — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'https://app.example.com'
corepack pnpm --filter @supastack/desktop dev
# Custom backend — macOS / Linux only:
SUPASTACK_APP_URL=https://app.example.com corepack pnpm --filter @supastack/desktop dev4. Verifique a janela, bandeja e atalho
Sucesso significa que a janela exibe a mesma página inicial do seu back-end no navegador. A janela da área de trabalho não possui barra de endereço do navegador. Para abrir a demonstração sem credenciais, saia do shell usando a ação Sair da bandeja e execute o bloco do sistema operacional abaixo no terminal da área de trabalho enquanto o servidor Web continua em execução. Isso carrega /dashboard diretamente; siga as etapas da tarefa local do tutorial da Web. O login na conta real usa o banco de dados do back-end, assim como no navegador.
Feche a janela usando o botão Fechar: o aplicativo deve ficar oculto na bandeja em vez de sair. Clique no ícone da bandeja do Supastack ou pressione Ctrl + Shift + Espaço no Windows/Linux, ou Command + Shift + Espaço no macOS, para mostrá-lo novamente. Use a ação Sair da bandeja para sair. Para finalizar o desenvolvimento completamente, pressione também Ctrl + C no terminal da área de trabalho e pare o terminal de back-end.
Se a janela estiver em branco ou mostrar um problema de conexão, primeiro abra o URL configurado em um navegador. Inicie o back-end ou corrija o URL e reinicie o Tauri. Se Rust relatar que linker.exe não foi encontrado, instale a carga de trabalho do Windows C++ e reabra o terminal. Se o Linux reportar uma biblioteca de sistema ausente, siga os pré-requisitos específicos da distribuição. Se a tecla de atalho já estiver em uso, use a bandeja e siga o comportamento nativo para alterá-la.
Isto abre uma janela de desenvolvimento local; ele não produz um instalador assinado nem publica um aplicativo. Siga a distribuição do Desktop para compilações de instaladores, assinatura de plataforma e testes em outra máquina. A compilação do Windows não verifica o comportamento do macOS ou do Linux.
# Open the local demo — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'http://localhost:3000/dashboard'
corepack pnpm --filter @supastack/desktop dev
# Open the local demo — macOS / Linux only:
SUPASTACK_APP_URL=http://localhost:3000/dashboard corepack pnpm --filter @supastack/desktop devUse a URL local do app
Sem uma substituição, o Tauri carrega http://localhost:3000. Defina SUPASTACK_APP_URL somente se seu app Next.js local usar outra origem HTTP(S) acessível. URLs com credenciais ou que não sejam web são rejeitadas.
O identificador do bundle de desenvolvimento e a configuração de release ainda não estão prontos para produção. Consulte o guia de release separado para a verificação prévia e a assinatura da plataforma.