Glossário
Os termos que aparecem na documentação, explicados em linguagem simples.
Publicar um app envolve alguns nomes que todo mundo usa e ninguém explica. Aqui está o que cada um significa na prática. Não precisa decorar: volte aqui quando um termo aparecer.
Infraestrutura
Backend
O "lado de lá" do seu app: o servidor onde ficam os dados dos usuários, o login e as regras. O app no celular é a vitrine; o backend é o estoque. No Kasy você escolhe entre Firebase (do Google), Supabase ou a sua própria API.
Deploy
Publicar algo num servidor. Quando você roda kasy deploy, as funções e regras do seu backend sobem para a nuvem e passam a valer. Sem deploy, elas só existem no seu computador.
Cloud Function / Edge Function
Um pedacinho de código que roda no servidor, não no app. Serve para tarefas que o app não pode fazer (guardar segredos, validar compras). Cloud Function é o nome no Firebase; Edge Function, no Supabase. Você não precisa escrevê-las: o kit já traz prontas e o kasy deploy as publica.
Webhook
Um "me avisa quando acontecer". Você dá uma URL sua para um serviço (RevenueCat, Stripe) e ele chama essa URL sozinho quando algo acontece: uma compra, um cancelamento. É assim que seu banco de dados fica sabendo que alguém assinou, mesmo com o app fechado.
Secret
Uma senha ou chave que nunca pode aparecer no código do app (qualquer pessoa consegue abrir um app e ler o que tem dentro). Secrets ficam guardados no servidor. Exemplo: a chave da OpenAI do chat IA fica num secret, e o app conversa com ela através de uma função sua.
.env
Um arquivo de texto na raiz do seu projeto com as chaves que o app usa (RevenueCat, Sentry, etc.), uma por linha. Ele fica fora do Git de propósito, assim as chaves não vazam quando você compartilha o código. O kasy run lê esse arquivo automaticamente.
Contas e login
OAuth
O padrão por trás do "Entrar com Google/Apple/Facebook". Em vez de criar mais uma senha, o usuário autoriza o app a usar a conta que ele já tem.
Origin autorizada
Na web, o Google só aceita login vindo de endereços que você cadastrou (ex.: https://seuapp.com). Se o login social falha na web, quase sempre é porque o endereço não está na lista.
Token
Um "crachá digital" que o app recebe quando o usuário loga e apresenta em cada pedido ao servidor. É assim que o servidor sabe quem está pedindo sem pedir a senha toda hora.
Lojas e pagamento
Sandbox
O ambiente de mentirinha das lojas: você faz uma compra com o modal real da Apple/Google, mas nenhum dinheiro é cobrado. Serve para testar antes de publicar. Detalhe: no Sandbox as assinaturas duram minutos (uma mensal renova a cada 5 min); é normal, não é bug.
Entitlement
A "permissão" que a compra libera no app. O usuário compra o produto premium_monthly → ganha o entitlement premium_access → o app libera o conteúdo. É o RevenueCat quem controla isso.
Offering / Paywall
Paywall é a tela "assine o premium". Offering é o conjunto de planos que aparece nela: você monta no painel do RevenueCat, sem mexer no código.
Trial
Período grátis antes da primeira cobrança ("7 dias grátis, depois R$ 19,90/mês"). Configura-se na loja, e o kit exibe automaticamente no paywall.
Bundle ID / Application ID
O "CPF" do seu app: um identificador único no formato com.suaempresa.seuapp. O da Apple chama Bundle ID; o do Android, Application ID. Precisa ser o mesmo em todos os lugares (projeto, App Store Connect, Play Console).
Keystore / Certificado
A "assinatura digital" que prova que o app é seu. O Android usa um arquivo keystore; a Apple usa certificados. Guarde com a vida: quem perde o keystore não consegue mais atualizar o app na Play Store.
Build number vs versão
Versão (1.0.2) é o que o usuário vê na loja. Build (42) é um contador interno que precisa aumentar a cada envio. O kasy ios release incrementa o build sozinho.
Web
DNS
A "lista telefônica" da internet: traduz seuapp.com para o endereço do servidor. Quando você aponta um domínio próprio para o Firebase Hosting ou Vercel, cria registros DNS no site onde comprou o domínio.
PWA
Progressive Web App: seu app rodando no navegador, mas instalável como se fosse nativo (ícone na tela inicial, funciona em tela cheia). O build web do Kasy já sai como PWA.
Ferramentas
CLI
Command-Line Interface: programa que você usa digitando comandos no terminal, em vez de clicando em janelas. O kasy é uma CLI.
MCP
Um plug que conecta sua IA (Claude, Cursor) a uma ferramenta externa. O caminho principal do Kasy é o MCP do Kasy (kasy-mcp): você cola um JSON no cliente e pede "prepara minha máquina", "cria um projeto", "rode o app" ou "publica o iOS", sem digitar a CLI. Página completa: MCP do Kasy. Instalação: Instalar o Kasy. Também existem MCPs de serviços de terceiros, como RevenueCat e Stripe, pra montar catálogo de assinatura pelo chat.
SDK
Um pacote de código pronto que um serviço fornece para o app conversar com ele (SDK do RevenueCat, do Firebase...). O kit já instala e configura os SDKs: você só encosta neles se quiser customizar.
Sentiu falta de algum termo? Os guias explicam os conceitos no contexto onde aparecem: comece pelos Conceitos.
Atualizado em 03/11/2026