CommunityImagemgithub.com

store-pack

Gera um pacote de submissão para Google Play e App Store (ícones, capturas de tela emolduradas nos tamanhos exatos das lojas, arte gráfica de destaque, texto da listagem com limites de caracteres, respostas de formulários do console, análise de bloqueadores) em uma pasta store/ no projeto. Use quando for solicitado a deixar um aplicativo "pronto para Play Store / App Store" ou para preparar assets da loja, listagens ou respostas de formulários do console.

O que é store-pack?

Esta skill automatiza a criação de todos os ativos necessários para submeter um aplicativo às lojas Google Play e Apple App Store, gerando uma pasta `store/` no diretório raiz do projeto. Ela produz ícones, capturas de tela emolduradas com gradientes e legendas, arte gráfica de destaque (feature graphic), textos de listagem com verificação de limites de caracteres, respostas para formulários de console e um README com análise de bloqueadores. A skill é projetada para ser executada localmente e nunca faz submissão, commit ou deploy, deixando essas ações para o usuário. Suporta apps Flutter, web, desktop e híbridos, utilizando Python 3 e o Flutter SDK para composição de imagens, e macOS para verificações de imagem. O fluxo de trabalho inclui inspeção do app para coletar fatos (não inventar), captura de screenshots reais com dados fictícios, e execução de scripts para gerar os pacotes de configuração, listagens e documentação, além de verificar bloqueadores comuns como problemas de pagamento, exclusão de conta, permissões restritas e segurança de dados.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nowfalsalahudeen/store-pack/tree/HEAD

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que store-pack faz?

Gera a pasta store/ na raiz do projeto: ícones, capturas de tela emolduradas, uma arte gráfica de destaque, texto da listagem, respostas de formulários do console e um README com bloqueadores. Nunca submeta, faça commit ou deploy; deixe isso para o usuário.

Requisitos: Python 3, o Flutter SDK (o compositor de imagens é um teste Flutter, nenhum aplicativo necessário) e macOS (para sips para verificação de imagens e tamanhos de ícones). As capturas de tela brutas vêm do próprio aplicativo.

Fluxo de Trabalho

  1. Inspecione o aplicativo para obter fatos (nunca invente): ID do pacote/bundle, versão, permissões (AndroidManifest, Info.plist), SDKs no pubspec, Cargo.toml ou package.json (anúncios, analytics, relatórios de falhas, faturamento, login), como funcionam contas e pagamentos, URLs de política de privacidade e suporte, configuração de assinatura, famílias de dispositivos. Leia a documentação de contribuição do próprio projeto para suas regras.
  2. Capturas de tela brutas. Capture do aplicativo real com dados inventados realistas. Nunca use dados de produção ou uma conta de produção.
    • Flutter: um harness de teste widget com fontes reais (debugDisableShadows = false, ou as sombras renderizam como contornos duros); telefone 440x956 em 3x = 1320x2868.
    • Web, desktop ou aplicativos híbridos: execute o próprio servidor do aplicativo em um banco de dados rascunho, alimente-o através da API e controle-o com uma ferramenta de automação de navegador. Use um contexto de navegador separado com deviceScaleFactor 3 (telefone, viewport 440x956) ou 2 (tablet, 1032x1376), e oculte as barras de rolagem com *::-webkit-scrollbar{display:none!important}*{scrollbar-width:none!important} antes de cada captura.
    • Mate apenas o processo ouvindo em sua própria porta rascunho (lsof -ti tcp:PORT -sTCP:LISTEN), nunca pelo nome.
    • Verifique cada captura visualmente. Descarte telas que estejam quebradas na largura e informe o usuário.
  3. store/app.json (veja docs/config-reference.md), então execute python3 scripts/make_pack.py store/app.json. Ele emoldura as capturas de tela em um gradiente de marca com uma legenda, cria uma arte gráfica de destaque e ícones, e executa scripts/check_pack.py.
    • Ícone: geralmente existe apenas arte com cantos arredondados embutidos ou texto; o trabalho icon corta a marca em um fundo sólido sem bordas. Informe ao usuário que ainda é necessário um vetor ou uma fonte limpa de 1024 px.
  4. Texto da listagem: store/listings.json, depois python3 scripts/write_listings.py store/listings.json (layout fastlane, limites aplicados). Descreva apenas o que a compilação realmente faz e o que a compilação da plataforma inclui.
  5. Documentação: store/README.md (tabela de bloqueadores primeiro), google-play/console-forms.md, app-store/connect-forms.md.

Especificações das lojas (confirme nos consoles; a página da Apple pode não carregar)

  • Play: ícone 512 px (<= 1 MB); arte gráfica de destaque 1024x500, sem alfa; 2-8 capturas de telefone, cada lado entre 320-3840 px e lado longo <= 2x lado curto (use 1080x1920); opcional capturas de tablet 7"/10" (1200x1920, 1600x2560); título 30, curto 80, completo 4000.
  • App Store: iPhone 6,9" 1320x2868 (obrigatório), 6,5" 1284x2778; iPad 13" 2064x2752 se iPad for suportado; até 10 cada; sem alfa; ícone 1024 px, sem alfa; nome 30, subtítulo 30, promo 170, palavras-chave 100.
  • Ambas rejeitam capturas de tela com canal alfa; o compositor escreve PNG RGB.

Bloqueadores a serem verificados em todo aplicativo (aprendido)

  • Pagamentos: vender desbloqueios digitais ou licenças por meio de um provedor de pagamento web dentro do aplicativo viola as regras do Play Billing / Apple IAP. Para iOS, envie sem interface de compra ou adicione StoreKit. Sem preços ou links de compra em compilações móveis.
  • Exclusão de conta: qualquer aplicativo que crie contas precisa de um caminho de exclusão no aplicativo e (Play) uma URL web pública descrevendo-o.
  • Entrar com Apple: exigido sempre que o login do Google ou outro terceiro for oferecido no iOS.
  • IDs de anúncios de teste deixados em uma versão de lançamento; IDs reais ausentes.
  • Play App Signing: adicione o SHA-1 de assinatura do Play aos clientes OAuth do Google Android, ou o login falhará em instalações do Play.
  • Permissões restritas ou declaradas: REQUEST_IGNORE_BATTERY_OPTIMIZATIONS, tipos de serviço em primeiro plano (precisa de declaração e vídeo), localização (mesmo com maxSdkVersion), Bluetooth neverForLocation.
  • Acesso do revisor: aplicativos que precisam de um servidor ou licença precisam de um servidor de demonstração, PIN e etapas (acesso ao aplicativo Play, diretriz 2.1 da Apple).
  • URL da política de privacidade deve existir; endereço de contato e telefone para status de comerciante (UE/UK).
  • Assinatura de lançamento configurada; aumento de versão; AAB para Play; equipe Apple e ID do bundle; ITSAppUsesNonExemptEncryption; manifesto de privacidade.
  • Novas contas pessoais Play: um teste fechado de 12 testadores por 14 dias é necessário antes da produção.
  • Segurança de dados: "processado efemeramente" apenas para dados usados na memória e nunca armazenados (por exemplo, uma foto enviada a um serviço de IA); email ou IDs mantidos em um servidor não são efêmeros. ID de publicidade: responda "Não" apenas se nenhum SDK de anúncio ou conversão estiver presente e a permissão de ID de publicidade for removida.
  • Público-alvo 18+ a menos que o aplicativo seja verdadeiramente para crianças.
  • Um ofuscador de tamanho mínimo (R8) pode falhar em bibliotecas opcionais: se uma compilação de lançamento falhar com "Missing classes", adicione regras -dontwarn para os pacotes nomeados.

Arquivos

  • scripts/make_pack.py executa tudo; scripts/compose/ é o compositor Flutter (STORE_JOBS=jobs.json flutter test); scripts/build_icons.py; scripts/check_pack.py; scripts/write_listings.py.
  • templates/app.example.json, templates/listings.example.json - configurações para copiar. examples/ - um exemplo completo com um aplicativo fictício e sua saída.
  • docs/ - guia de início, referência de configuração, como funciona.

Habilidades Relacionadas