Compiss: como o Claude CLI vibe-codou um app de achar banheiro

I used Claude cli to vibe code a compass app to find the nearest toilet, called Compiss. I used Claude cli on my Mac to generate all the code, assets and e2e tests while making a compass app to find the nearest toilet. There are others out there but none of them are called Compiss :) Jokes aside, I found the public toilet search on the built in apps a little lacking so I built this to capture some of the features I found useful. I like to think of it as a mix between Waze and a toilet finder app. Compiss allows you to rate the cleanliness of toilets, add comments or photos (subject

O Compiss é um aplicativo que aponta, como uma bússola, o banheiro público mais próximo: além de localizar, deixa você avaliar a limpeza, adicionar comentários e fotos, e ainda traz um Modo Aperto para emergências. A parte mais interessante não é o app em si, e sim como ele foi feito: todo o código, os assets e os testes E2E saíram do Claude CLI rodando no terminal de um Mac.

O caso Compiss: como o Claude CLI permitiu criar um app multiplataforma do zero

O desenvolvedor descreve o Compiss como uma mistura entre Waze e um localizador de banheiros, construído depois de achar que a busca de banheiro público nos apps nativos deixava a desejar. Em vez de montar uma equipe ou meses de desenvolvimento, ele usou o Claude CLI para gerar código, assets visuais e testes de ponta a ponta direto no terminal. O resultado foi um app que unificou as bases do OpenStreetMap e do toiletmap.org.uk para lançar versões no iOS, Android, Apple Watch e na web, todas sem anúncios.

O detalhe que chama atenção é a abrangência: quatro plataformas partindo de uma única conversa de terminal. Isso só é possível porque o Claude CLI trabalha direto no seu sistema de arquivos, lendo e editando o projeto, rodando comandos e ajustando o código em loop. Você descreve o que quer, ele gera, executa, encontra o erro e corrige, tudo sem sair da linha de comando.

Fluxo prático e comandos essenciais do Claude CLI para prototipagem rápida

Quem nunca usou uma ferramenta de linha de comando pode estranhar o começo, mas o fluxo é mais simples do que parece. Você abre o terminal, aponta o Claude CLI para a pasta do projeto e começa a pedir. Ele navega pelos arquivos, entende a estrutura e propõe mudanças. A cada passo, você revisa, aprova ou pede ajuste, e ele executa.

1. Inicialize o projeto e deixe o Claude CLI “ler” a estrutura existente antes de pedir qualquer coisa grande
2. Peça mudanças pequenas e testáveis, uma de cada vez, para o contexto não estourar
3. Deixe ele rodar os comandos de build e teste no lugar de copiar e colar manualmente
4. Revise o diff antes de aceitar, mesmo quando o resultado parece perfeito

Testes E2E e geração de assets no terminal: o que a IA faz e onde precisa de ferramentas externas

Uma das alegações do projeto é que o Claude CLI gerou os testes E2E e os assets, também no terminal. Isso funciona bem para testes de API, lógica e integração que rodam via linha de comando. O que merece ressalva é a ideia de autonomia total: testes de interface visual e E2E que dependem de um navegador ou simulador real costumam exigir ferramentas de automação externas, como Playwright ou Appium. O Claude CLI escreve o código do teste, mas a execução e a observação do resultado às vezes ficam por sua conta.

O mesmo vale para assets. Ícones simples, SVGs e imagens de fundo saem bem do gerador de código. Já ilustrações complexas, mockups de tela e animação pedem ferramentas de design dedicadas. A vantagem do fluxo do Compiss é justamente usar o terminal como ponto de partida e deixar o material bruto pronto, para depois refinar onde a IA não alcança.

Gerenciamento de janela de contexto e controle de custos na API do Anthropic

Trabalhar em um projeto multiplataforma significa alternar entre bases de código de iOS, Android, Apple Watch e web. Isso multiplica o tamanho do contexto, e o custo da API do Anthropic cresce junto. Um erro comum é acreditar que uma assinatura básica cobre tudo: para projetos grandes e com muitas idas e vindas, o consumo de tokens sobe rápido, e entender a gestão de janela de contexto vira parte do trabalho.

A prática que mantém o custo sob controle é a mesma que mantém a qualidade: pedir por partes, salvar resumos do que já foi feito e religar o Claude CLI ao contexto resumido em vez de recarregar tudo do zero. Quem domina esse ciclo faz muito mais com o mesmo orçamento.

Da execução local à publicação: superando os desafios das lojas de aplicativos

Rodar sem erros no simulador local não é o mesmo que estar pronto para a loja. O Compiss passou pelo caminho completo, e é aí que vibe coding deixa de ser só diversão: o aplicativo foi desenvolvido via Claude CLI com recursos como avaliação de higiene e o Modo Aperto, mas as lojas impõem revisões de segurança, privacidade, permissões e diretrizes de conteúdo que a IA não aprova sozinha.

É nesse ponto que o conhecimento de infraestrutura, Git e os processos de cada loja volta a ser necessário. O Claude CLI acelera absurdamente a construção, mas a publicação e a manutenção continuam exigindo você. A ferramenta reduz o atrito, não elimina a responsabilidade.

FAQ: Vibe Coding e desenvolvimento de apps com Claude CLI

Preciso saber programar para usar o Claude CLI? Não para começar, mas você vai esbarrar em terminal, Git e infraestrutura em algum momento. Quanto mais dessas bases você tiver, mais rápido resolve os erros que a IA não consegue sozinha.

O Claude CLI faz testes E2E 100% sozinho? Ele escreve o código dos testes. A execução visual e a validação de interface em navegador ou simulador costumam depender de ferramentas externas de automação.

A assinatura básica do Claude cobre um app multiplataforma completo? Depende muito do tamanho do projeto. Alternar entre várias bases de código infla o contexto e o consumo de tokens, então prepare-se para gerenciar isso ativamente.

Se rodou no simulador, está pronto para publicar? Não. As lojas têm requisitos de segurança, privacidade e conteúdo que exigem revisão humana, independentemente de o app funcionar na sua máquina.

Se você quer dar esse salto do protótipo para um produto de verdade, o primeiro passo é dominar o fluxo por partes. No guia de vibe coding você encontra o caminho completo para transformar uma ideia em algo que funciona, sem se perder no processo.