Backend Firebase (banco de dados + contas)

1O que isso dá ao seu app#

Normalmente seu app gerado guarda os dados apenas no celular em que está rodando. Ativar o Firebase dá ao app um banco de dados gratuito na nuvem, para que os mesmos dados fiquem visíveis em qualquer dispositivo e (se você quiser) as pessoas possam se cadastrar com e-mail + senha.

É TRAGA-O-SEU-PRÓPRIO - o app conversa com o SEU projeto Firebase gratuito. O AppMint não hospeda nada e não cobra nada extra. Você cola uma configuração uma vez; a IA escreve todo o código.

Você NÃO precisa escrever nem projetar nada - sem tabelas, sem esquema, sem SQL. O Firebase + AppMint descobrem tudo a partir da descrição do seu app.

2Crie o projeto Firebase (5 min, grátis)#

É mais fácil em um computador:

1. Abra console.firebase.google.com e entre com qualquer conta Google.
2. Toque em 'Adicionar projeto' → dê qualquer nome → continue clicando em 'Continuar' → pule o Google Analytics → 'Criar projeto'. Aguarde ~30 segundos.
3. No menu à esquerda: Databases & Storage → Firestore → 'Create database'.

• Escolha um local perto dos seus usuários (não dá para mudar depois).
• Escolha 'Start in production mode' - NÃO 'test mode'. O modo de teste expira automaticamente em 30 dias e seu app para de funcionar sem avisar.

1. No menu à esquerda: Security → Authentication → 'Get started' → aba 'Sign-in method':

• Ative 'Email/Password' (ligue o primeiro interruptor e salve).
• ATIVE TAMBÉM 'Anonymous' (role para baixo, ative e salve) - necessário para apps de convidado/ranking.

É só isso. Não há esquema para projetar.

Abrir o Firebase Console →

3Copie sua configuração web#

Ainda no Console do Firebase:

1. Toque na engrenagem ⚙️ (canto superior esquerdo) → 'Configurações do projeto'.
2. Role até 'Seus apps' → toque no ícone </> (web).
3. Dê qualquer apelido ao app → toque em 'Registrar app' (pule o 'Firebase Hosting').
4. Você verá um trecho de código. Copie APENAS o objeto firebaseConfig - tudo desde a { de abertura até a } de fechamento.

A chave de API web foi feita para ser pública - seus dados são protegidos pelas regras de segurança da etapa 6, não por esconder a chave.

const firebaseConfig = {
  apiKey: "AIza...",
  authDomain: "my-app.firebaseapp.com",
  projectId: "my-app",
  storageBucket: "my-app.appspot.com",
  messagingSenderId: "123456789",
  appId: "1:123:web:abc"
};   ← copy the { ... } part

4Cole no AppMint (uma vez)#

Abra AI Studio → Configurações → role até 'BACKEND - FIREBASE (OPCIONAL)':

1. Cole o firebaseConfig que você copiou na caixa de texto grande.
2. Ative o interruptor 'Ativar backend Firebase'.
3. Toque em 'Salvar configuração do Firebase'. Você deve ver 'Projeto Firebase salvo: <your-project-id>'.

Fica armazenada criptografada no seu dispositivo e é reutilizada em todo app que você gerar - você só faz isso uma vez.

5Descreva seu app - a IA faz o resto#

Diga o que você quer, em linguagem simples. A IA decide se adiciona telas de login ou não, com base no que você pedir:

• 'Um app de notas em que cada usuário salva as próprias notas' → a IA cria cadastro/login + notas privadas.
• 'Um ranking global para um jogo de toques, sem contas' → a IA usa login silencioso de convidado, pontuações públicas e nenhuma tela de login.
• 'Um mural compartilhado onde todos podem postar' → a IA usa login de convidado, sem tela de login.

Se o dispositivo estiver offline ou a configuração estiver ausente, o app volta automaticamente para o armazenamento somente no celular, para nunca travar.

6Aplique as regras de segurança (OBRIGATÓRIO)#

Sem esta etapa, o app receberá erros de 'permission denied' ao tentar ler ou gravar. A IA escreve as regras PARA VOCÊ; você só precisa colá-las.

1. Depois de gerar seu app, abra a visualização de código (ou descompacte o projeto baixado) e encontre o arquivo chamado 'firestore.rules'. Toque nele e copie TODO o texto.
2. No Console do Firebase: Databases & Storage → Firestore → aba 'Rules' → toque em 'Edit rules' → apague o que está lá → cole as regras da IA → toque em 'Publish'.

Faça isso uma vez por app. As regras são sob medida para o seu app - elas permitem que os usuários gravem apenas os próprios dados, enquanto os rankings continuam publicamente legíveis.

7Verifique se funciona#

Verificação rápida depois de instalar o APK:

1. Abra o app no celular e faça uma ação que deveria salvar dados (criar uma nota, enviar uma pontuação etc.).
2. De volta ao Console do Firebase: Databases & Storage → Firestore → aba 'Data' → você deve ver uma nova coleção (por exemplo, 'notes' ou 'scores') com os dados que acabou de inserir.
3. Segurança → Authentication → aba 'Users' → se seu app usa login, sua conta deve aparecer aqui.

Se nada aparecer: verifique as 3 causas mais comuns na próxima etapa.

8Se algo não funcionar#

Os erros mais comuns:

• 'permission-denied' ou dados não sendo salvos → você esqueceu a etapa 6 (publicar as regras).
• 'auth/operation-not-allowed' no cadastro/login → você não ativou Email/Password na etapa 2.
• 'auth/operation-not-allowed' em apps de convidado/ranking → você não ativou Anonymous na etapa 2.
• 'auth/operation-not-allowed' no login do Google → você não ativou o Google E colou a impressão digital SHA-256 (veja a etapa 'Adicionar Google Sign-In' abaixo).
• Configuração colada rejeitada ('Couldn't find a { ... } config object') → cole o bloco { ... } INTEIRO, incluindo as chaves, e não só o conteúdo de dentro.

Métodos de login compatíveis nos apps gerados: E-mail/senha, Anônimo (convidado), Google Sign-In (via Credential Manager nativo) e Telefone/SMS (via reCAPTCHA). O login com Facebook É compatível: informe seu Facebook App ID e Client Token na etapa Integrar do assistente (o login abre em uma aba do navegador). O login com Apple/Twitter ainda NÃO é compatível - eles exigem pop-ups OAuth que o Google bloqueia dentro da WebView do Android.

9Adicionar Google Sign-In (opcional)#

Os apps gerados podem usar o Google Sign-In pelo Credential Manager nativo do Android - funciona dentro da WebView (ao contrário dos pop-ups OAuth). Configuração única por app:

1. Console do Firebase → Security → Authentication → aba 'Sign-in method' → ative 'Google'. Salve.
2. Console do Firebase → ⚙ Configurações do projeto → 'Seus apps' → se você ainda não tem um app Android registrado, toque em 'Adicionar app' → Android → informe o nome do pacote (o mesmo que você usará no AppMint).
3. Compile seu APK uma vez no AppMint. Abra o arquivo '<appname>_signkey_info.txt' baixado - no topo você verá as impressões digitais SHA-1 e SHA-256.
4. De volta ao Console do Firebase → ⚙ Configurações do projeto → Seus apps → app Android → 'Adicionar impressão digital' → cole o SHA-1 e depois 'Adicionar impressão digital' de novo para o SHA-256. Toque em 'Salvar'. O Google Sign-In verifica o SHA-1: só com o SHA-256 ele falha com 'No credentials available'. (Você só faz isso UMA vez por app - a mesma chave de assinatura é usada em todas as compilações futuras.)
5. Publicando no Google Play? O Play reassina seu app com a chave dele, então uma instalação pelo Play tem uma impressão digital DIFERENTE. Play Console → seu app → Testar e lançar → Integridade do app → copie o SHA-1 e o SHA-256 em 'Certificado da chave de assinatura do app' e adicione os dois ao mesmo app Android no Firebase. Se pular isso, o login funciona pelo APK mas falha para todos que instalam pelo Play.
6. Console do Firebase → ⚙ Configurações do projeto → Geral → role até 'Seus apps' → encontre a seção Web SDK → copie o 'Web client ID' (termina em .apps.googleusercontent.com).
7. Abra Configurações do AppMint → cole em 'GOOGLE SIGN-IN - OAUTH WEB CLIENT ID'. Salve.
8. Recompile seu app. O Google Sign-In agora funciona.

10Adicionar login por telefone / SMS (opcional)#

A autenticação por telefone usa o Firebase Web SDK + reCAPTCHA (funciona dentro da WebView). O usuário digita o número de telefone, toca em uma verificação 'Não sou um robô', recebe um código por SMS e o digita.

Configuração:

1. Console do Firebase → Security → Authentication → aba 'Sign-in method' → ative 'Phone'. Salve.
2. Não precisa de SHA (usamos verificação reCAPTCHA, não Play Integrity).
3. Basta pedir à IA o login por telefone na descrição do app (por exemplo, 'Os usuários entram com o número de telefone').

⚠️ Cobrança: enviar SMS de verificação reais agora exige o plano Blaze (pague conforme o uso) - o plano gratuito Spark não inclui mais uma cota grátis de SMS. Faça o upgrade em Console do Firebase → ⚙ Configurações do projeto → Uso e faturamento. No Blaze, o Firebase Authentication permite até 3.000 SMS de verificação por dia; o preço do SMS varia por país.

💡 Para testar SEM cobrança ou SMS real: Authentication → Settings → 'Phone numbers for testing' permite adicionar um número de teste fixo + código (nenhum SMS é enviado).

Cotas e preços do Firebase Auth →

11Custo - o que esperar#

O plano gratuito 'Spark' do Firebase cobre a maioria dos apps de hobby. Grátis por dia:

• 50.000 leituras de documentos
• 20.000 gravações
• 20.000 exclusões
• 1 GiB de armazenamento total
• 10 GiB / mês de rede de saída

Para referência: um pequeno app de notas com 100 usuários ativos faz ~5.000 leituras/dia. Um ranking de jogo viral pode passar de 50 mil leituras em uma hora.

⚠️ Configure um alerta de orçamento: Google Cloud Console → Faturamento → Orçamentos e alertas → defina 'Alertar em US$ 1'. Você fica seguro e o Firebase envia um e-mail assim que o uso começar a gerar custo.

Configure um alerta de orçamento →