Explorando um app

Depois de entrar em um workspace de branch, estes comandos ajudam você a entender o app sem abrir o Bubble: summary, tree, context, schema, docs, guidelines, data, test-user e login.

Superfícies de nível superior

buildprint summary
buildprint summary --json

O comando summary lista páginas, visualizações móveis, elementos reutilizáveis, elementos globais, tipos de dados, conjuntos de opções, estilos e chamadas do API Connector. Cada entrada inclui o nome de exibição, id quando disponível e o caminho do arquivo no workspace.

Comece por aqui quando ainda não conhecer a estrutura do app.

Árvores de elementos

buildprint tree home
buildprint tree home --include text,types,ids,paths
buildprint tree home --depth 2
buildprint tree home --cursor 250

Os alvos podem ser nomes de páginas/reutilizáveis/móveis, chaves de pasta ou ids de elementos. O conjunto padrão de inclusão é types,ids,layout.

Flags úteis:

• --include <list> aceita text, types, ids, paths, layout, design, properties, workflows e actions. actions implica workflows.

• --depth <n> limita a profundidade da saída a partir do alvo. 0 imprime apenas o alvo.

• --cursor <n> pagina a saída. As páginas da árvore têm 250 linhas.

Contexto para um nó

buildprint context page-home
buildprint context pages/home/elements/button/element.json
buildprint context wf-submit

O comando context aceita um caminho JSON do workspace, um id de nó exato, uma chave de mapa app-json exata ou caminho lógico, ou um nome exato. Ele imprime contenção, relações de gatilho de workflow, referências e relações de instanciação reutilizáveis.

Se um alvo for ambíguo, o comando imprime candidatos para que você possa tentar novamente com um caminho de arquivo ou um id mais exato.

Busca de esquema do Bubble

buildprint schema "append text"
buildprint schema --category actions
buildprint schema "count" --category operators --upstream-type list
buildprint schema --element-type Group --surface web_page
buildprint schema "api connector" --json

O comando schema pesquisa o esquema estático do Bubble no Buildprint. Forneça uma consulta, pelo menos uma --category ou um filtro de contexto como --element-type.

Filtros úteis incluem --upstream-type, --element-type, --action-type, --workflow-type, --data-type, --owner-type e --surface. --limit aceita de 1 a 20 resultados.

Documentação e diretrizes

buildprint docs buildprint "auth token"
buildprint docs buildprint "version syncing" --limit 10
buildprint docs bubble
buildprint guidelines list
buildprint guidelines get general
buildprint guidelines get editing/apps schema/workflow

docs buildprint pesquisa a documentação do Buildprint. docs bubble retorna o payload llms.txt do Bubble e orientações de curl. guidelines expõe as diretrizes do agente local do Buildprint para edição de arquivos do app, workflows, esquema e testes.

Leitura de dados em tempo de execução

O comando data lê registros do banco de dados do Bubble por meio do Buildprint. Ele não lê arquivos locais do workspace.

Dentro de um workspace, o app e a versão assumem como padrão o app do workspace e a branch atual. Fora de um workspace, passe ambos --app <appId> e --version <live|test|branch>.

buildprint data search '{"type":"custom.project","constraints":[{"key":"_all","constraint_type":"contains_all_fields","value":"acme"}],"n":5}'
buildprint data fetch '["1670000000000x1234567890"]'
buildprint data aggregate '[{"type":"custom.project","constraints":[],"aggregate":{"fns":[{"fn":"count"}]}}]'

Para payloads maiores, use --file <path> ou --stdin. Adicione --json para uma saída compacta legível por máquina. data search aceita até 400 resultados por solicitação.

Usuários de teste

Os usuários de teste são registros gerenciados pelo Buildprint para o app do workspace atual:

buildprint test-user list
buildprint test-user get t17...
buildprint test-user create --name "Test customer" --database test --email [email protected]
buildprint test-user update t17... --database test --disable
buildprint test-user delete t17...

A maioria dos subcomandos suporta --json. As senhas podem ser passadas com --password, lidas da entrada padrão (stdin) com --password-stdin ou limpas com --clear-password na atualização.

Login no navegador como usuário (Run-as-user)

buildprint login [email protected]
buildprint login [email protected] --page checkout
buildprint login [email protected] --session checkout-test
buildprint login [email protected] --no-browser

O comando login solicita ao Buildprint cookies de run-as-user e os instala no Agent Browser, quando disponível. Use-o antes de realizar testes baseados em navegador como um usuário específico do Bubble.