> ## 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

# 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](https://supastack.dev/pt/docs/web/before-you-start.md)

[Aprenda como executar um comando e editar um arquivo](https://supastack.dev/pt/docs/web/terminal-basics.md)

[Lista de verificação de pré-requisitos do sistema operacional de Tauri](https://tauri.app/start/prerequisites/)

[Instalador oficial do Rust](https://rustup.rs/)

```
rustc --version
cargo --version
corepack pnpm install
```


## 2. 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.

[Execute um back-end local da Web](https://supastack.dev/pt/docs/web/ship-in-5-minutes.md)

[Prepare contas reais com Postgres](https://supastack.dev/pt/docs/web/database.md)

```
# Only when this checkout contains apps/web:
corepack pnpm --filter @supastack/web dev
```


## 3. 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 dev
```


## 4. 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.

[Configurar janela nativa e comportamento de atalho](https://supastack.dev/pt/docs/desktop/run.md)

[Crie e verifique instaladores de desktop](https://supastack.dev/pt/docs/desktop/release.md)

```
# 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 dev
```


## Use 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.


## Seguinte

[Execute e configure o shell](https://supastack.dev/pt/docs/desktop/run.md)