KasyKasy

Nome do app

Comece com um nome provisório e troque depois com um comando só.

Ainda não sabe o nome? Crie o projeto com qualquer nome provisório e comece a construir. Quando decidir, um comando troca o nome em todos os lugares onde o Kasy escreveu.

Implementação

Pelo MCP (recomendado): peça ao assistente "troca o nome do app para Lanchonete Boa". Ele mostra uma prévia, pergunta se o app já foi enviado para as lojas e só aplica depois do seu sim (rename_app). Veja MCP do Kasy.

  1. Veja o que vai mudar (nada é gravado):

    kasy rename "Lanchonete Boa" --dry-run
  2. Aplique:

    kasy rename "Lanchonete Boa"

    No terminal ele pergunta o que fazer com o ID do app (veja abaixo). Pra rodar sem perguntas:

    kasy rename "Lanchonete Boa" --bundle-id auto        # troca o ID para com.lanchoneteboa.app
    kasy rename "Lanchonete Boa" --bundle-id com.suaempresa.app
    kasy rename "Lanchonete Boa" --keep-bundle-id       # mantém o ID atual
  3. Pare o app e rode kasy run de novo. O nome embaixo do ícone e o ID são nativos: r/R não basta.

O ID do app só pode ser trocado antes de publicar. Depois do primeiro envio para a App Store ou Google Play (vale TestFlight e teste interno), o ID fica preso àquele app para sempre. Trocar cria outro app na loja, sem usuários, avaliações nem assinaturas. Defina o ID final antes do primeiro envio. O nome visível você troca quando quiser.

Informações

Nome visível x ID do app

ExemploQuem vêTroca depois de publicar?
Nome visívelLanchonete BoaUsuário: embaixo do ícone, na aba do navegador, dentro do appSim, sempre
ID do app (Bundle ID no iOS, applicationId no Android)com.lanchoneteboa.appSó as lojas e os serviços (Firebase, login social, RevenueCat)Não

Na página da loja, o nome exibido é o que você cadastra no App Store Connect e no Play Console. Ao trocar o nome do app depois de publicar, atualize lá também.

O que o comando muda

  • Sempre: nome embaixo do ícone (Android e iOS, em todos os idiomas), título da aba e do app instalado na web (PWA), título do app, mockup de notificação do onboarding, kit_setup.json e README.
  • Também sempre (técnico): o pacote Dart (package:... nos imports) e o canal de notificação do Android. Eles derivam do nome e o Kasy mantém tudo sincronizado, pra kasy add e kasy update continuarem funcionando.
  • Só se você trocar o ID: Android (applicationId, namespace e pasta do Kotlin), iOS (Bundle ID do app e das extensões, App Group do widget), codemagic.yaml e o cadastro do app no Firebase, que é feito automaticamente.

A pasta do projeto não é renomeada. Se ela ficou com o nome provisório, renomeie com o editor fechado.

Depois de trocar o ID

  • Firebase: o comando registra o ID novo sozinho. Se estiver sem internet, rode kasy rename de novo depois: ele percebe e completa. O cadastro antigo continua no console do Firebase, sem atrapalhar.
  • Celular ou simulador: o app antigo continua instalado como outro app. Pode desinstalar.
  • O que você já configurou com o ID antigo: login social (kasy google, kasy apple-web, kasy facebook), assinatura iOS (kasy ios), Codemagic (kasy codemagic) e RevenueCat precisam do ID novo. O próprio comando lista o que vale pro seu projeto.

Trocando o nome de um app já publicado

Use kasy rename "Novo Nome" --keep-bundle-id. O nome muda e o ID fica. O Android cria uma categoria de notificação nova com o nome novo; ajustes que o usuário tinha feito na categoria antiga não passam pra ela. No backend Firebase, rode kasy deploy depois, pra as notificações push usarem a categoria nova.

Atualizado em 03/11/2026