Instalación

Necesitas dos cosas en tu máquina: la CLI builder (que incluye el engine) y Bun, el runtime en el que se ejecutan los schematics. El SDK en sí se agrega por proyecto — normalmente de forma automática.

Esta guía fue verificada contra la CLI 0.6.0 y el SDK 0.2.x.

macOS / Linux

Con Homebrew instalado, obtén la CLI (el binario builder) desde el tap:

brew install project-builder-schematics/tap/pbuilder

Linux / WSL2

Esto requiere un Homebrew reciente — la instalación del cask está verificada en Homebrew 6.x; las versiones anteriores rechazan casks en Linux.

¿No tienes Homebrew? Descarga el tarball de tu plataforma desde los releases del tap (pbuilder_<version>_linux_amd64.tar.gz y compañía) y coloca builder en tu PATH — sin necesidad de brew.

Los schematics se ejecutan a través de un sidecar de Bun, así que Bun también debe estar instalado:

brew install oven-sh/bun/bun   # o bien: curl -fsSL https://bun.sh/install | bash

Nota

Bun es únicamente el runtime de los schematics — tu proyecto conserva el gestor de paquetes y las herramientas que ya usa (npm, pnpm, yarn, …).

Windows

Aún sin soporte

Las builds de la CLI para Windows están en el roadmap; mientras tanto, la vía soportada en Windows es WSL2 (Ubuntu), usando las instrucciones de Linux de arriba.

El SDK en sí

Normalmente no lo instalas a mano — builder init agrega @pbuilder/sdk a las devDependencies de tu proyecto automáticamente. Para agregarlo manualmente, usa el gestor de paquetes que tu proyecto ya utilice:

npm install -D @pbuilder/sdk    # o bien: pnpm add -D / yarn add -D / bun add -d

Con la CLI y Bun en su lugar, estás listo para tu primer schematic.