Badge Studio
The design toolkit · Node.js 22+

Same design.
Another way in.

Start with a badge. Let your agent edit its layers. Bring it back to the studio to see it move.

01 / Meet badgio

Badge Studio from your terminal. Run the CLI without installing it globally.

npx badgio --help
npx badgio styles list

The package is called badgio. It runs on Node.js 22 or newer and works without an account or AI key. Install it globally with npm install --global badgio if you prefer.

02 / Pick your starting point

npx badgio styles list
npx badgio design create --style gtm --out badge.json

Seventeen editable directions: nine event references, three physical originals and five custom explorations. The file contains both faces, every layer and the material recipe. Existing files are never overwritten.

03 / Make it yours with your agent

npx badgio schema --json
npx badgio design validate --file badge.json

Ask your agent to edit badge.json using the schema: typography, positions, shapes, portrait treatments, effects and materials. Keep the name and role bindings so the same design works for different people.

“Turn this into an editorial badge with cobalt type and warm paper. Keep the portrait and a clear QR. Validate it before handing it back.”

The CLI creates and validates documents locally. Your agent supplies the creative changes. It does not call an LLM or generate images itself.

04 / Bring it to life

Open the editor and choose Importar JSON in the header. Upload your portrait, refine either face, and export PNG or the editable JSON.

Artwork references are separate from the document. Built-in assets ship with the studio; custom artwork can be imported into your browser's design library.

Open the editor ↗