All docs

Docs › Palmtop › Português

Guia rápido do Palmtop

Dez minutos do zero até um app no seu celular que você fez descrevendo, e entregou para alguém. Só duas partes precisam de uma explicação: dizer ao Palmtop quem cria, e o ciclo criar → usar → mudar. O resto é um toque.

1 · Coloque o Palmtop no seu celular

Três caminhos, e é o mesmo Palmtop. O app web funciona hoje; os dois apps de loja estão na última etapa antes do lançamento.

O app web — funciona hoje, em qualquer celular

Abra priorstates.com/palmtop/webapp no navegador do celular e adicione à tela inicial: essa cópia é o Palmtop de verdade: o armazenamento é permanente, funciona sem internet, e os círculos e o que compartilham com você chegam lá.

Daí em diante abra o Palmtop pela tela inicial. Uma aba comum do navegador tem o próprio armazenamento separado; é por isso que um convite aberto em uma aba pede para enviá-lo ao Palmtop da tela inicial.

Android — download, hoje

Baixe o app pela página do Palmtop no celular e abra; o Android pede uma vez para permitir instalações pelo navegador. É o mesmo app que o Google Play vai ter, assinado com a chave do Play, então quando a página da loja abrir ela atualiza como qualquer outro app.

iPhone — TestFlight, hoje

Você já pode instalar pelo TestFlight da Apple: entre no beta pelo próprio celular; instale o TestFlight quando ele pedir e depois o Palmtop. É a mesma versão do app web, em um contêiner que coloca o Palmtop no seu menu de compartilhar. A versão da App Store ainda está em análise na Apple; quando sair, o beta vira o app da loja.

Os apps de loja acrescentam a única coisa que um app web não pode ter: o Palmtop no menu de compartilhar do celular, assim um app ou um convite que mandam para você abre direto nele em vez de em uma aba do navegador.

Cada cópia do Palmtop guarda as próprias coisas: um app web na tela inicial e um app de loja são dois Palmtops separados no mesmo celular, e nenhum vê os apps do outro. Para migrar, toque em Ajustes→Fazer backup de tudo no antigo e Restaurar… no novo. Sua chave de IA e o pareamento com o computador ficam de fora do arquivo de propósito, porque esse arquivo viaja; configure de novo na cópia nova (um minuto, passo 2).

2 · Configure a IA: quem cria

O Palmtop não vem com uma IA dentro; você traz uma. Abra Ajustes→Quem cria e escolha uma das duas. Dá para trocar depois; as duas deixam seus apps no celular.

A · IA neste celular — o caminho rápido

  1. No celular, pegue uma chave gratuita em aistudio.google.com/apikey (só precisa de uma conta Google).
  2. De volta ao Palmtop: Ajustes→IA neste celular, cole a chave, toque em Salvar e depois em Testar.
  3. Deixe o modelo em Flash-Lite (recomendado): o nível gratuito permite muito mais solicitações por minuto do que os modelos Flash completos, e uma criação são 5–10 solicitações seguidas.

A chave fica neste celular; as solicitações vão do celular direto para o Google.

Na China continental, onde o Google não é acessível: em Serviço escolha Zhipu GLM (chave gratuita em open.bigmodel.cn; o GLM-4-Flash não custa nada) ou Alibaba Bailian Qwen (bailian.console.aliyun.com; contas novas recebem uma cota gratuita) e cole essa chave. As solicitações vão do celular direto para esse serviço.

B · O agente de programação do meu computador — criações mais fortes, apps guardados em git

  1. No computador onde o Claude Code (ou o Codex) está instalado e logado, instale o PriorStates Hub, macOS, Windows ou Linux, e abra.
  2. Aperte Start e depois Pair a phone: aparece um código QR. Escaneie com a câmera do celular (abre no Palmtop), ou copie o link em Ajustes→O agente de programação do meu computador.
  3. Toque em Verificar conexão. Longe de casa o celular chega ao hub por um relay criptografado que não consegue ler o tráfego. O hub mantém esse computador acordado enquanto roda; aperte Stop quando terminar.

Seus apps ficam em um repositório git no computador; Enviar ao git / Trazer do git nos Ajustes os movem entre aparelhos.

A aba Criar diz qual cérebro está ativo em uma linha abaixo da conversa (“Criando com o Gemini neste celular” ou “Criando com o agente de programação do seu computador”). Se disser que nenhuma IA está configurada, volte aqui.

3 · Crie seu primeiro app

  1. Abra a aba Criar. As fichas no topo são conversas: Geral, + Novo, e uma para cada app que você tem.
  2. Toque em + Novo e descreva o app em uma ou duas frases: diga para que serve e o que deve mostrar. Peça em português e o app sai em português:
    • “Um formulário de pedidos para as verduras desta semana: tomate, pepino, ovos com preços; quantidade por linha, um total, o nome do cliente, um botão Enviar.”
    • “Um checklist de mala para um fim de semana, agrupado em roupas, higiene, documentos; marcar os itens.”
    • “Uma votação para o jantar de sexta com quatro opções; cada um vota uma vez e vê os totais.”
  3. Envie ↑ e acompanhe a conversa: a IA planeja, escreve os arquivos e diz done (com o número de rodadas que levou). Uma criação leva de menos de um minuto a alguns minutos.
  4. Vá à aba Apps: o novo ícone está lá. Toque nele.

O que funciona melhor: um app por pedido, substantivos concretos (os itens, os campos, os botões) e a finalidade (“para os pedidos semanais do sítio”). Não precisa dizer como: nem tecnologia, nem instruções de layout.

4 · Use, mude

Tocar em um ícone abre o app em tela cheia. A barra do topo tem ‹ voltar, ↻ recarregar, ⤴ compartilhar e 🐞: abrir o construtor, que pula para a aba Criar na conversa deste app com “Algo está errado:” pronto para completar. Esse é o ciclo:

  1. Use o app. Repare no que falta ou está errado.
  2. 🐞 (ou Criar → a ficha do app) e diga: “adicione um seletor de data de entrega abaixo das observações”, “o total deve incluir a taxa de 5%”, “deixe os botões maiores”.
  3. done → abra o app de novo. Os dados (a lista que você tinha preenchido) continuam lá.

Segure um ícone para o menu dele: Abrir, Editar com IA, Compartilhar, Caixa de entrada (para apps que coletam respostas), Excluir. Organizar na aba Apps deixa arrastar ícones e fazer grupos (Meus, Família, …).

5 · Comece por um modelo

Apps→Galeria tem cinco apps prontos: um formulário de pedidos, uma lista de inscrição, uma votação, um checklist e um divisor de despesas. Toque em Instalar, abra e faça dele o seu do mesmo jeito: Criar → a ficha dele → “troque os itens por …”. Um modelo costuma ser um primeiro passo mais rápido do que descrever do zero. Os modelos vêm em inglês; “passe para português” é uma frase para o construtor.

6 · Compartilhe: WhatsApp incluído

Para uma pessoa

No menu do app ou na barra do topo, Compartilhar → Compartilhar link. O app é criptografado no seu celular; só o link tem a chave. Mande por onde quiser: WhatsApp, iMessage, e-mail. A pessoa abre no Palmtop e confirma Instalar. Você decide se os seus dados vão junto (para uma lista preenchida, é justamente o ponto). Exportar arquivo faz o mesmo como arquivo.

Vai publicar em um lugar público, um grupo, um fórum, uma rede social? Deixe Cartão de prévia marcado e adicione uma captura de tela: o link se abre com a imagem, o nome e a descrição do app, e a página dele diz a quem não tem o Palmtop onde conseguir. O cartão é público; o app continua criptografado.

Para um grupo: círculos

Círculos→Novo círculo, depois Convidar: mande o link para a família, a turma ou a equipe (no grupo do WhatsApp, por exemplo). Publique um app no círculo com ＋; todos recebem Instalar, e quando você publica uma atualização recebem Atualizar.

Respostas. Um formulário que você compartilha (pedidos, inscrição, votação) devolve as respostas para você: segure o ícone dele → Caixa de entrada, onde dá para exportá-las como planilha. A ida e volta completa, dos dois lados: formulários que respondem (em inglês).

Se algo der errado

🌐 Abrir o Palmtop Sobre o Palmtop Privacidade