> ## 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 móvel em 5 minutos

Abra o aplicativo Expo em um telefone ou simulador, configure um endereço API que o dispositivo pode alcançar e diferencie uma visualização da IU de login real e compras nativas.

## 1. Prepare o computador, telefone e back-end

Conclua Antes de iniciar e abra o repositório móvel ou o monorepo de todas as plataformas em seu editor. Em Terminal → Novo Terminal na raiz do repositório, execute o comando de instalação abaixo. Espere terminar. Instale Expo Go em seu telefone usando a página oficial Expo com link abaixo; sua versão deve suportar a versão Expo SDK registrada em apps/mobile/package.json.

Um back-end é o servidor Web que lida com login, dados do espaço de trabalho e solicitações de IA. Se o seu checkout contém apps/web, primeiro execute a configuração da Web em outro terminal e deixe o servidor em execução. Conclua a configuração do Postgres antes de tentar a inscrição ou login nativo. Um checkout somente para dispositivos móveis não contém apps/web: em vez disso, conecte-o ao seu back-end em execução fornecido separadamente. Iniciar Expo inicia o servidor de visualização de tela, não o backend.

Coloque seu telefone e computador no mesmo Wi-Fi. Desconecte temporariamente um VPN se ele bloquear conexões locais. O localhost de um telefone significa o próprio telefone. Use o endereço de rede privada do seu computador para um telefone físico ou dispositivo Android; O Simulador iOS no mesmo Mac pode usar http://localhost:3000, e o Android Emulator normalmente usa http://10.0.2.2:3000.

[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)

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

[Instale uma versão Expo Go compatível com seu projeto](https://expo.dev/go)

```
corepack pnpm install
```


## 2. Encontre e teste o endereço de back-end

No Windows, execute ipconfig em um novo terminal PowerShell, encontre seu adaptador Wi-Fi ativo e leia o endereço IPv4. No macOS, abra Configurações do sistema → Wi-Fi → Detalhes → TCP/IP e leia o endereço IP. No Linux, abra as configurações de rede e leia Endereço IPv4. Um endereço pode ser semelhante a 192.168.1.25; o seu geralmente será diferente.

Se o endereço do seu computador for 192.168.1.25, abra http://192.168.1.25:3000 no navegador do telefone enquanto o servidor Web estiver em execução. Substitua seu endereço real. A página inicial deve carregar antes de prosseguir. Permita o aplicativo Node em redes privadas se o Firewall do Windows solicitar. Caso não carregue, verifique o endereço, Wi-Fi, firewall e servidor Web em execução; um túnel Expo carrega apenas o pacote de visualização e não torna seu API separado acessível.

```
# Windows PowerShell only:
ipconfig
```


## 3. Crie o arquivo de configuração do aplicativo móvel

No Explorer do editor, expanda apps → mobile, crie um novo arquivo chamado .env.local e cole a configuração abaixo nesse arquivo. Substitua 192.168.1.25 pelo endereço que você acabou de testar ou use o endereço de back-end HTTPS fornecido. Salve o arquivo. Seu caminho completo é apps/mobile/.env.local; root .env não é lido automaticamente por Expo.

Mantenha a configuração de compra do telefone desativada para a primeira visualização. EXPO_PUBLIC_ significa que uma configuração está incluída no aplicativo de telefone, portanto, esses valores devem conter apenas URLs públicos, esquemas e configurações públicas do cliente. Não cole segredos de provedor de IA, banco de dados ou faturamento aqui. O servidor Web possui seu próprio apps/web/.env.local; alterar o arquivo Mobile não altera o servidor.

```
EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=supastack
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off
```


## 4. Inicie Expo e abra a visualização

Na raiz do repositório, execute o comando abaixo. Aguarde um código QR e a mensagem de espera do Metro. Mantenha este terminal e o terminal de back-end abertos. No Android abra Expo Go e escaneie o código QR; no iPhone, use a Câmera, escaneie o código e abra-o em Expo Go. O código QR abre o aplicativo de desenvolvimento, não a página inicial do back-end.

Sucesso significa que a tela de login do aplicativo será aberta no seu dispositivo. Com as compras desativadas, esta é uma prévia da IU; conclua a configuração da autenticação da Web baseada em banco de dados antes de testar o login, os espaços de trabalho salvos ou o bate-papo. Se o seu objetivo for um simulador instalado, pressione a no terminal Expo para Android ou i para iOS. O Simulador iOS requer macOS e Xcode; ele não pode ser executado no Windows.

```
corepack pnpm --filter @supastack/mobile start
```


## 5. Recupere-se de erros de visualização e teste fluxos reais

Se Expo Go relatar um projeto incompatível, compare seu SDK compatível com apps/mobile/package.json e use a versão compatível da página oficial Expo. Não atualize as versões de dependência do kit apenas para descartar a mensagem. Se um módulo nativo necessário não estiver disponível, siga as compilações móveis para obter uma compilação de desenvolvimento contendo esse módulo.

Se o login falhar devido a um erro de rede, primeiro tente novamente o back-end URL no navegador do telefone. Se o URL funcionar, mas o login falhar, inspecione o terminal de back-end e verifique o Postgres e as migrações. A sessão de demonstração local/painel não faz login no telefone. Se a configuração parecer obsoleta, pressione Ctrl + C no terminal Expo, execute o comando de reinicialização abaixo e reabra a visualização.

Expo Go não pode provar o comportamento real de compra/restauração do StoreKit ou do Play Billing. Siga as compras no aplicativo e as compilações móveis para uma compilação de desenvolvimento EAS e armazene contas de teste. As primeiras compilações nativas e o registro da conta podem levar mais de cinco minutos. Para interromper esta visualização, pressione Ctrl + C no terminal Expo; pare o back-end separadamente quando terminar.

[Configurar e testar o login nativo](https://supastack.dev/pt/docs/mobile/authentication.md)

[Crie uma versão de desenvolvimento nativa](https://supastack.dev/pt/docs/mobile/builds.md)

[Configurar compra e restauração nativa](https://supastack.dev/pt/docs/mobile/revenuecat.md)

```
corepack pnpm --filter @supastack/mobile start --clear
```


## Seguinte

[Executar a app mobile](https://supastack.dev/pt/docs/mobile/local-setup.md)