Publicação e atualização de componentes

Transforme uma parte de um dos seus apps Bubble em um componente reutilizável para que você (e, após aprovação, todos) possam inseri-lo em outros apps. Você pode fazer isso de duas maneiras: peça ao seu agente Buildprint para fazer isso, ou execute a CLI você mesmo.

A maneira mais fácil: peça ao seu agente

Seja no chat do app web Buildprint ou trabalhando pelo seu agente CLI, basta descrever o que publicar:

• "Empacote este fluxo de checkout da Stripe como um componente."

• "Publique nossa estrutura de dados de faturamento na biblioteca do workspace."

• "Atualize o componente de manipulação de webhooks com as alterações que acabei de fazer."

O agente reúne os arquivos do componente, escreve sua documentação e executa a etapa de empacotamento para você. Este é o caminho recomendado — você não precisa aprender o formato de arquivo.

O que um pacote de componente contém

Se preferir criá-lo diretamente (ou quiser saber o que o agente produz), um componente é descrito por alguns arquivos no workspace da sua branch:

• library.json — a biblioteca à qual ele pertence: slug, nome, descrição, status da listagem (internal por padrão ou public) e uma imagem de destaque opcional.

• component.json — o próprio componente: slug, nome, breve descrição, status, categorias, dependências, os arquivos do workspace a incluir (nodes), o caminho do README e os caminhos das imagens.

• README.md — a descrição longa do componente. É isso que as pessoas leem na página do componente, então deve explicar o que o componente faz e como funciona. É obrigatório incluir estes títulos: Overview, How to apply e Requirements.

• os arquivos e imagens do workspace referenciados em component.json.

Descrições

• Breve descrição (shortDescription em component.json, até 120 caracteres) é o resumo de uma linha exibido no cartão do componente.

• Descrição longa (seu README.md, até 10.000 caracteres) é o texto completo exibido na página do componente. Quem o ler deve sair entendendo o que o componente faz, como aplicá-lo e o que ele requer.

// component.json
{
  "manifestVersion": 1,
  "library": "stripe-billing",
  "slug": "checkout-flow",
  "name": "Checkout Flow",
  "shortDescription": "A checkout page and backend webhook pattern.",
  "status": "public",
  "categories": ["ui", "api"],
  "dependencies": ["billing-data-structure"],
  "nodes": ["pages/checkout", "api/webhooks/stripe"],
  "readme": "README.md",
  "images": ["images/cover.png"]
}

Publicação ou atualização com a CLI

No workspace da sua branch, execute:

buildprint components package

Isso valida seus manifests e README, agrupa os arquivos referenciados e faz o upload do pacote. Flags úteis:

• --dry-run — valida e cria o pacote sem enviá-lo.

• --library <path> / --component <path> — aponta para locais de manifest não padrão.

Atualizar um componente usa o mesmo comando: empacote-o novamente com o mesmo library e o mesmo slug do componente, e o Buildprint atualiza o componente existente no local (novos arquivos, descrição, imagens e status).

Todo o trabalho com componentes passa pela CLI do Buildprint (ou pelo agente, que a utiliza). Não edite componentes publicados manualmente — reempacote-os para que o catálogo permaneça sincronizado.

Categorias

Marque cada componente com uma ou mais categorias para que as pessoas possam encontrá-lo:

database, ui, workflow, expression, api, plugin.

Liste as categorias válidas a qualquer momento com:

buildprint components categories

Dependências

Se um componente precisar de outro componente da mesma biblioteca, liste-o em dependencies (pelo slug). Quando alguém instalar seu componente, o Buildprint também puxará as dependências. Um componente não pode depender de si mesmo, e as dependências são resolvidas dentro da mesma biblioteca.

Compartilhando no marketplace

Por padrão, uma biblioteca é internal — publicada apenas no seu workspace. Para colocá-la no marketplace público, empacote a biblioteca com status de listagem public. Ela então entra em Awaiting approval e um administrador do Buildprint a revisa antes de ela entrar no ar.