Todas as coleções

Explorando um app

Assim que estiver dentro de um workspace de branch, cinco comandos cobrem tudo o que você precisa para entender um app sem abrir o Bubble: summary, tree, context, schema e docs.

Superfícies de nível superior: summary

buildprint summary

Lista páginas, visualizações mobile, elementos reutilizáveis, elementos globais, tipos de dados, conjuntos de opções, estilos e chamadas do API Connector. Cada entrada mostra o nome de exibição, o id do Bubble e o caminho do arquivo que você pode abrir.

Use buildprint summary --json para um formato legível por máquina ao criar scripts.

Árvores de elementos e fluxos de trabalho: tree

buildprint tree <target>

O alvo é uma página, reutilizável, visualização mobile ou elemento. Você pode passar a chave da pasta, o nome amigável ou o id do Bubble.

Flags úteis:

  • --include <list> — conjunto de extras separados por vírgulas. Opções: text, types, ids, paths, layout, design, properties, workflows, actions. O padrão é types,ids. actions implica workflows.

  • --cursor <n> — deslocamento de paginação. A saída da árvore é paginada em 250 linhas por vez; o rodapé informa o próximo cursor.

Relacionamentos para um nó: context

buildprint context <node-id-or-name-or-file-path>

Para um único nó, imprime:

  • Assunto — sobre o que você perguntou.

  • Contido por e Contém — hierarquia.

  • Acionado por e Acionadores — conexão do fluxo de trabalho.

  • Referências e Referenciado por — leituras e gravações em outros lugares do app.

  • Instancia Reutilizável e Instanciado por — conexão de reutilizáveis.

Para elementos, a saída também inclui uma seção ## Tree com até cinco ancestrais e cinco níveis de descendentes.

Se um nome ou id for ambíguo, o comando encerra com uma lista de candidatos para que você possa tentar novamente com um caminho totalmente qualificado.

Buscas de esquema do Bubble: schema

buildprint schema [query...] [--category <name>] [--action-type <type>] [--element-type <type>] [--limit <n>]

Pesquisa na cópia do Buildprint do esquema estático do Bubble — cada operador, ação, tipo de elemento, tipo de fluxo de trabalho, superfície e assim por diante. Use-o quando não tiver certeza de qual formato um nó espera.

Exemplos:

buildprint schema "append text"
buildprint schema --category actions
buildprint schema --action-type CreateThing

Pelo menos uma consulta, --category ou um filtro de contexto deve ser fornecido.

Buscas de documentação: docs

  • buildprint docs buildprint <query> — pesquise na central de ajuda do Buildprint de dentro da CLI. Use --limit para ajustar a contagem de resultados (padrão 5, máx. 50).

  • buildprint docs bubble — busca o próprio payload llms.txt do Bubble para acesso rápido às entradas do manual do Bubble.

Dicas

  • Comece novas tarefas com summary para obter um mapa do app antes de aprofundar.

  • tree --include properties,workflows é a maneira mais rápida de entender o que uma página realmente faz.

  • context é muito mais barato que tree quando você só se preocupa com os vizinhos de um nó.

Isso foi útil?