Saltar al contenido principal

Stellar Scaffold

Pasa de un directorio vacío a una dApp de Stellar desplegada sin conectar las piezas tú mismo.

cargo binstall stellar-scaffold-cli
Inicio Rápido →¿Usas IA? Copia nuestro prompt para empezar.

Inicio Rápido

Instala la CLI, crea un proyecto y pon a funcionar un contrato y un frontend contra una red local en pocos minutos.

Empieza aquí →

Tutorial

Crea una dApp completa de principio a fin: escribe el contrato, conecta el cliente generado, añade pagos y refuérzala.

Crea una dApp →

Referencia de la CLI

Cada comando en detalle: init, build, generate, watch y upgrade, además de la configuración que lee cada uno.

Consulta un comando →

Registro

Publica un WASM, despliega instancias de contrato con nombre y reutiliza contratos que otras personas ya han publicado.

Publica y despliega →

¿Desarrollas con un agente de IA?

Pégalo en Claude Code, Codex, Cursor u otro agente de programación. Instala Scaffold, te pide el nombre del proyecto, crea el proyecto y le indica al agente nuestra Agent Skill para todo lo demás.

Help me start a new Stellar Scaffold project.

1. Read the Stellar Scaffold agent skill and follow it for everything below: https://raw.githubusercontent.com/stellar-scaffold/cli/main/skills/stellar-scaffold/SKILL.md
2. Check that I have Rust with the wasm32v1-none target, a C toolchain, the Stellar CLI (`stellar`), Node.js, and Docker running. If anything is missing, tell me how to install it before going further.
3. Tell me that Scaffold works best with Stellar Registry: if I'm going to be deploying to Testnet or Mainnet, I'm going to want stellar-registry-cli in addition to stellar-scaffold-cli. Do I want to install both now?
4. Install Scaffold CLI and, if I opted in, Registry CLI with `cargo binstall stellar-scaffold-cli [stellar-registry-cli]`, installing cargo-binstall first if I don't have it (see https://stellarscaffold.org/docs/quick-start). Confirm it works with `stellar scaffold version` and `stellar registry version`.
5. Ask me for a project name. Ask me if I want a frontend and, if so, do I want React, Svelte, or to use a community template (if the latter, coach me through the `user/repo` shorthand (optionally with a `#branch`/`#tag` suffix) that the `--template` option expects). Ask me if I am ok with NPM or if I'd like another package manager from the `--package-manager` choices.
6. Run `stellar scaffold init <name> --template [my choice] --package-manager [my choice]`. The first run downloads the local network's Docker image and deploys the example contracts, so it can take several minutes. Warn me.
7. For a frontend project, start `npm run dev` in the project. It keeps running, so run it in the background or ask me to run it, then point me to http://localhost:5173.

Then ask me what I'd like to build.
Sobre la Agent Skill →

¿Qué es Stellar Scaffold?

Stellar Scaffold es un plugin para la CLI de Stellar que crea y mantiene proyectos Soroban de pila completa. Genera el workspace de contratos en Rust, una plantilla de frontend y los clientes TypeScript tipados que conectan ambos, y mantiene esos clientes sincronizados a medida que cambian tus contratos.

Está pensado para la parte del trabajo que no es tu idea: configurar la red local, las direcciones de despliegue, la regeneración de clientes y la configuración de entornos. Tú escribes contratos e interfaz; el conjunto de herramientas mantiene el cableado correcto.

Lee la introducción →

El flujo de trabajo

Itera en local tan rápido como guardas y despliega en testnet y mainnet cuando lo decidas. Compilar contratos, ejecutar la red local y generar clientes TypeScript ocurre por sí solo.

  1. Crearstellar scaffold init my-project

    Configura los contratos, un frontend en el framework que elijas y el código utilitario que los conecta, ya integrados.

  2. Desarrollar en localnpm run dev

    Ejecuta una red local y vigila tu código. Cada vez que guardas, recompila y vuelve a desplegar los contratos que cambiaron, regenera sus clientes tipados y recarga el frontend.

  3. Publicarstellar registry publish

    Cuando un contrato está listo, publica su Wasm en el Stellar Registry y despliégalo por nombre: primero en testnet como staging y luego en mainnet. Estos despliegues son pasos deliberados, nunca un efecto secundario de guardar un archivo.

Mientras desarrollas, un único scaffold.yml versionado declara tus redes, cuentas y contratos, para que todo tu equipo compile el mismo proyecto, y ese mismo archivo lo lleva de local a testnet y a mainnet. Las comprobaciones de configuración detectan errores antes de compilar y, cuando algo falla, Doctor revisa tu toolchain, la configuración y la red local de una vez y te dice cómo arreglar lo que encuentra.

Ver todos los comandos →