Marketplace

O que é e como abrir

O Marketplace não é uma das cinco páginas do pager principal. Ele abre como uma sobreposição em tela cheia sobre o que você estava fazendo, com telas próprias: Início, busca, uma lista de categoria, a página do recurso e Minha biblioteca.

Seis formas de entrar

Não há entrada do Marketplace em Configurações.

Como se movimentar

• Voltar é o gesto de voltar do sistema. A partir de qualquer tela ele sobe para o Início; a partir do Início ele fecha o Marketplace (e leva de volta ao editor, se você veio dele). Não há setas de voltar na tela.
• Na primeira vez: uma boas-vindas de três cartões (Um catálogo curado, Instalação com um toque, Sua biblioteca) com Pular, Próximo e Entendido. Ela aparece uma única vez.
• De onde vem o catálogo: do servidor do PocketCode, api.pocketcodeapp.com. O app não traz nenhum catálogo, então explorar exige conexão. Só Minha biblioteca (Instalados e Salvos) funciona offline.
• Conta: explorar não exige conta; instalar exige. O painel de Snippets do editor diz isso com as palavras do próprio app: “Entre para instalar snippets do Marketplace. Para vê-los não é preciso conta.”

Início

O Início é a primeira tela. Todas as seções carregam em paralelo e só aparecem quando têm algo a mostrar. Puxe para baixo para atualizar todas, ou toque em Recarregar. Se nada carregar, você vê Não foi possível carregar o marketplace com Tentar novamente.

No topo: o campo Buscar no marketplace (ele só abre a Busca; você digita lá), o ícone Minha biblioteca e o ícone Recarregar.

Busca e filtros

Toque no campo Buscar no marketplace do Início. O teclado abre com o cursor já no campo. A busca roda no servidor do catálogo e atualiza um quarto de segundo depois que você para de digitar, ou quando você aperta a tecla de busca. Você recebe até 30 resultados em cartões compactos. Sem nada para mostrar, você vê Nenhum resultado para “…”; se o servidor não responder, você vê Não foi possível carregar com uma nova tentativa, então uma falha de rede nunca parece um resultado vazio. Com o campo vazio, a Busca lista Buscas recentes (até 8; um termo é salvo ali quando você toca na tecla de busca) e Navegar por categoria; Limpar esvazia o campo.

Filtros

O ícone Filtros abre Filtrar resultados, com um número no ícone enquanto há filtros ativos. Tipo lista os 12 tipos de recurso (incluindo Plugins e Workflows), Plano tem Grátis e Pro, e Categoria lista as categorias do catálogo. Escolha no máximo um chip por grupo (toque de novo para limpá-lo, ou use Qualquer) e depois Aplicar; Limpar tudo zera os três grupos. Os filtros funcionam com a busca vazia, então você pode listar, por exemplo, todos os temas Pro.

Categorias e Ver tudo

Um chip de categoria (no Início ou na Busca) ou Ver tudo abre uma lista com o nome da categoria ou da seção como título. É uma grade de cartões que carrega 30 por vez conforme você rola. Se estiver vazia, você vê Nada por aqui ainda — volte em breve; se a rede falhar, um erro com nova tentativa. Para restringir uma lista por tipo, use Filtros na Busca.

Ordenar por oferece Populares (mais baixados), Mais recentes e Avaliação. A ordenação é aplicada no seu celular ao que já foi carregado, porque o servidor do catálogo só ordena pela última atualização. A lista sempre começa em Populares, inclusive depois de Ver tudo em Novos e atualizados.

A página de um recurso

Toque em qualquer cartão para abrir a página do recurso. Tudo o que você precisa para decidir está nela, e os botões que o instalam também. O que o botão principal faz depende do tipo do recurso (veja a próxima seção).

Cabeçalho e detalhes

• Barra de título. Mostra o tipo do recurso (Temas, Páginas, Botões…), não o nome. À direita: Salvar, Compartilhar e o menu ⋮ com Denunciar.
• Resumo. O ícone, o nome, o autor (toque para abrir o perfil) e a categoria, depois uma linha com a avaliação (um traço enquanto não há avaliações) e a contagem, os downloads e o Plano, exibido como um selo PRO ou uma etiqueta Grátis.
• Cartão de tipo. Um cartão diz o que o botão principal vai fazer: Snippet de código, Tema do editor, Slash command de IA, Pacote de regex, Servidor MCP, Persona de agente de IA, Template de projeto, Plugin executável (também usado para workflows) ou Recurso não suportado.
• Prévia antes de instalar. Temas, pacotes de regex, servidores MCP, prompts e agentes podem mostrar amostras de cor, padrões de exemplo, o comando de inicialização ou um trecho curto, quando o catálogo fornece.
• Capturas de tela e recursos parecidos. Quando o recurso tem capturas de tela, elas vêm em seguida, e no final Similar a este (Outros recursos que podem te interessar) lista os recursos relacionados que o catálogo sugere.
• Salvar e Compartilhar. Salvar guarda o recurso em Salvos sem instalá-lo (toque de novo, Remover marcador, para desfazer). Compartilhar envia Name · https://pocketcodeapp.com/m/<slug> pela folha de compartilhamento do sistema.
• Quando não carrega. Você vê o texto de erro da requisição que falhou, ou Não foi possível carregar este recurso quando não há texto. Se não houver nada para mostrar, Recurso não encontrado.

Instalar, aplicar e salvar

Se o recurso é Pro e você está no plano Free, a linha de instalação inteira é substituída pelo cartão Recurso Pro (veja Free, Pro e o teste de temas). Caso contrário, os botões dependem do tipo. Enquanto uma instalação roda, o botão vira um indicador de progresso para que um toque duplo não a dispare duas vezes, e uma mensagem informa o resultado. A página não troca o botão para “Instalado”; o que muda é que a aba Conteúdo e a caixa de avaliação aparecem. O que acontece quando você toca:

1. 1Se o recurso declara permissões, primeiro abre Permitir que este recurso… (abaixo). Um template de projeto também verifica se o seu plano tem espaço para mais um projeto antes de baixar qualquer coisa.
2. 2O app pede ao servidor do PocketCode um link de instalação, enviando o recurso e a versão do seu app. O servidor confere se você está logado, se o plano do recurso cabe no seu plano e se o seu app é recente o bastante, e responde com um link de download assinado e com prazo de validade.
3. 3O app baixa o bundle e confere a impressão digital SHA-256 dele com a que o servidor anunciou. Se o servidor também fornece uma assinatura Ed25519, ela é verificada com a chave pública do marketplace. Se algo não bater, a instalação para e o download é descartado.
4. 4O bundle é descompactado no cache do app. Qualquer coisa acima de 512 MB ou 20.000 arquivos, qualquer coisa que se expanda a mais de 200 vezes o tamanho compactado, e qualquer caminho que tente sair da própria pasta, é recusada.
5. 5O recurso é aplicado conforme o tipo (tabela na próxima seção) e adicionado a Minha biblioteca.
6. 6O app informa ao servidor se a instalação funcionou: o ID do recurso e sucesso ou falha.

Abas

Até seis abas, e nem sempre todas:

Permissões: um aviso, não uma sandbox

Quando um recurso declara permissões, tocar no botão principal dele (ou em um secundário, como Copiar) abre primeiro Permitir que este recurso…: “Verifique o que este recurso pode fazer no seu dispositivo. Você pode instalá-lo mesmo assim ou cancelar.” Ela lista uma linha por permissão, por exemplo Ler arquivos dos seus projetos, Modificar arquivos dos seus projetos, Fazer requisições de rede, Inserir código no seu editor, Alterar o tema do seu editor, Ler ou alterar configurações do app, Adicionar ferramentas ao seu chat de IA, Iniciar um processo de servidor MCP, Executar comandos do shell, Escrever na área de transferência e Ler segredos / chaves de API armazenados. Uma permissão que o diálogo não conhece aparece como texto bruto. Um servidor MCP sempre lista Iniciar um processo de servidor MCP, mesmo que o manifest dele não traga. Toque em Instalar mesmo assim ou Cancelar.

Avaliações

A aba Avaliações lista as avaliações públicas, 20 por vez com Carregar mais: estrelas, data e texto, sem nomes. Vazia: Sem avaliações ainda. Seja o primeiro. Para escrever uma, o recurso precisa estar instalado neste dispositivo: o cartão Sua avaliação só aparece então. Escolha de 1 a 5 estrelas, adicione um texto opcional (até 1.000 caracteres) e toque em Publicar avaliação. Se falhar, você vê Não foi possível publicar sua avaliação. Tente novamente.

Denunciar este recurso

⋮ → Denunciar abre Denunciar este recurso: “Conte o que está errado. As denúncias são revisadas pela equipe.” Escolha um de cinco motivos (Malicioso ou inseguro, pré-selecionado, Spam ou enganoso, Não funciona, Conteúdo inapropriado ou Outro), adicione uma nota opcional de até 500 caracteres e toque em Enviar denúncia. Você recebe Obrigado pela denúncia — vamos revisá-la. ou Não foi possível enviar a denúncia: …. O app não mostra o que acontece com a denúncia depois.

Autor e capturas de tela

• Autor. Tocar no nome do autor abre um painel em tela cheia com o avatar (se houver), o nome, a bio, um ícone Autor verificado quando o catálogo o marca como verificado e N recursos deste autor; toque em um para abrir a página dele. O app encontra o autor por um slug derivado do nome; se isso falhar, você vê Não foi possível carregar o perfil deste autor.
• Capturas de tela. Aparecem como uma fileira de miniaturas. Toque em uma para ver em tela cheia, toque na imagem para ir à próxima (volta ao início depois da última) e use o botão de fechar para sair. O app mostra quantas capturas o catálogo fornecer.

Os 12 tipos de recurso

O catálogo tem 12 tipos de recurso. Filtros lista os 12, e um recurso de um tipo que esta versão do app não reconhece mostra um botão desativado Recurso não suportado. A tabela dá o botão principal de cada tipo e o que a instalação faz.

Um recurso cujo tipo esta versão não conhece diz “Este recurso usa um tipo que o app ainda não reconhece. Tente atualizar o PocketCode.” Tudo o que você instala também aparece em Minha biblioteca.

Servidores MCP começam desligados

Um servidor MCP é um processo Node que roda com as mesmas permissões do PocketCode, então o Marketplace nunca inicia um por você:

1. 1Toque em Conectar servidor MCP. O app confere a linha de inicialização: só node ou npx são aceitos, e ele recusa as flags que executam código (-e, --eval, -p, --print, -r, --require, --import, --loader, --experimental-loader e, para npx, também -c e --call). As variáveis NODE_OPTIONS e NODE_PATH são descartadas. Só os servidores node conseguem de fato iniciar: o app não tem npm, então um npx é instalado desligado e, ao ligá-lo, as Configurações mostram “npx is not available: npm is not bundled with the app”.
2. 2O servidor é salvo desligado e aguardando confirmação, e uma mensagem leva você a Configurações > MCP. Essa tela se chama Servidores MCP.
3. 3Ligue o servidor lá. Um diálogo com o título Este servidor vai ser executado no seu celular mostra a linha de inicialização e diz que ele roda com as mesmas permissões do PocketCode. Só Executar o inicia; cancelar o deixa desligado. Depois de confirmado, ele inicia com o app nas próximas aberturas; não precisa abrir Configurações > MCP toda vez.
4. 4Se uma versão posterior do recurso mudar o comando, os argumentos ou o ambiente, o servidor volta desligado e pergunta de novo. Se nada mudou, a sua decisão anterior é mantida.

Minha biblioteca

Toque no ícone Minha biblioteca do Início. As listas vêm de um banco de dados no seu celular: cada linha é algo que você instalou ou salvou. Instalados e Salvos funcionam offline; Atualizações precisa de conexão.

Atualizações, Instalados e Salvos

• Instalados (N) lista tudo o que está instalado neste dispositivo. Uma linha mostra o ícone do tipo, o nome, “tipo • autor • versão” e dois ícones: Reaplicar e Remover. Vazia: Sem instalações ainda.
• Salvos (N) lista os recursos que você salvou, instalados ou não. Remover marcador tira um da lista; para um recurso que não está instalado, também o remove da biblioteca. Vazia: Sem itens salvos.
• Atualizações (N) só existe enquanto algo tem uma versão mais nova. Quando você abre Minha biblioteca, o app pergunta ao catálogo a versão mais recente de tudo o que você instalou, em uma única requisição em lote (puxe para baixo para verificar de novo), e compara os números de versão. Uma linha mostra v1.0.0 → v1.1.0. Não há botão de atualizar na linha: toque nela para abrir a página do recurso e instalar de novo, o que baixa a versão mais recente. Se a verificação falhar, o último bom resultado é mantido em vez de afirmar que está tudo atualizado.

Reaplicar e Remover

Reaplicar funciona a partir do bundle já guardado no celular, sem download. Remover não pede confirmação e mostra … removido da sua biblioteca. O que cada um faz depende do tipo:

Preferências do marketplace

• O ícone de engrenagem (Configurações da biblioteca) abre Preferências do marketplace.
• Atualizar recursos automaticamente vem desligado por padrão: “Uma vez por dia, em Wi-Fi e carregando, instala novas versões de cada recurso já na sua biblioteca.” Ele confere as versões e só baixa um recurso que tenha uma assinatura Ed25519 válida. As atualizações são aplicadas em silêncio: snippets, páginas e botões só atualizam a cópia guardada; as cores de um tema são atualizadas sem trocar o seu tema; um template nunca cria outro projeto; prompts, pacotes de regex, agentes e componentes são reescritos no lugar; um servidor MCP cuja linha de inicialização mudou volta desligado. Se pelo menos um recurso foi atualizado, você recebe uma notificação Marketplace atualizado, sujeita às suas configurações de notificação e ao horário de silêncio.
• Resgatar código promocional: digite o código (até 40 caracteres, convertido em maiúsculas enquanto você digita) e toque em Resgatar. Em caso de sucesso você vê N dias de Pro adicionados — aproveite. Os erros estão em Solução de problemas.

Publicação

Você não pode publicar um recurso pelo app. Não há tela de envio, nem botão Publicar, nem recurso Pro que libere isso. No celular o catálogo é somente leitura, e a equipe do PocketCode publica o conteúdo dele fora do app, por um repositório interno e verificações automatizadas.

Free, Pro e o teste de temas

O Marketplace não tem um bloqueio de plano próprio. O que depende do seu plano é o plano do próprio recurso, o limite de projetos para os templates e o limite de snippets personalizados do painel de Snippets do editor.

Recursos Pro e o teste de tema de 5 minutos

• Em um recurso Pro enquanto você está no plano Free, a linha de instalação vira o cartão Recurso Pro: “Assine o PocketCode Pro para instalá-lo.” com Obter Pro, que abre a tela de assinatura. A descrição, as capturas de tela, as avaliações e as abas continuam visíveis. Se o servidor responder que o recurso exige Pro, você também cai na tela de assinatura.
• Em um tema Pro você também recebe Testar tema por 5 min, quando disponível. Ele aplica o tema e, cinco minutos depois, devolve o que você tinha; o cronômetro sobrevive ao fechamento do app. Você tem um teste por tema e dispositivo, e só um de cada vez.
• O limite de projetos aparece como Projetos Ilimitados: “O plano gratuito inclui um projeto e ele já está em uso. Assine o Pro para adicionar mais, ou exclua um projeto de que não precisa mais.” Nada é baixado e isso não conta como instalação.