Ship your first contribution in 5 minutes

The shortest path is your AI agent. Open the kit folder in Claude Desktop, Claude Code, Cursor, or Codex and tell it what you want to ship — the agent reads the kit’s CLAUDE.md, installs the Vincia CLI for you on first use, scaffolds the project, runs the preview, applies your feedback, and publishes when you’re ready. You stay in chat.

Watch the workflow

Auto-advances every few seconds. Hover to pause; click any step to jump.

Step 1 of 6

Download the kit

Get the Designer Kit or Developer Kit zip from Studio and unzip it. The kit folder is everything your agent needs.

Prefer the CLI directly?

Same CLI the agent uses, just without an agent in the loop. Pick your track:

Developer track — plugins, blueprints, solution packs

1. Install the CLI

curl -fsSL https://get.vincia.io/install | bash    # macOS / Linux
# Windows (PowerShell):
# iwr -useb https://get.vincia.io/install.ps1 | iex
# or, if you prefer npm:
npm install -g https://get.vincia.io/cli/0.1.0/vincia-cli-0.1.0.tgz

Verify with vincia --version and vincia doctor.

2. Sign in

vincia login --token <vct_…>

Issue a contributor token from Studio’s /developers/tokens page and paste it. Interactive browser sign-in is rolling out; until then --token is the path. Self-hosted? Add --studio-url https://studio.your-host.com.

3. Scaffold a contribution

vincia create blueprint my-app
vincia create connector my-payment --capability payment
vincia create workflow-node my-transform
vincia create widget my-kpi-card
vincia create solution-pack my-clinic-pack

Connector capabilities: payment, storage, notification, auth-provider, mailbox.

4. Develop locally

cd my-payment vincia dev          # sandboxed sidecar with hot reload vincia test         # unit tests

5. Discover what already exists

vincia capabilities         # current capability list
vincia interfaces           # SDK interface contracts
vincia examples             # bundled worked examples
vincia info <id>            # details on a marketplace contribution
vincia search <query>       # search the marketplace

6. Publish

vincia publish --dry-run

Runs the same checks the marketplace will run, locally, and prints the diff against the latest published version. Drop the --dry-run to submit.

Designer track — templates, themes, libraries, collections

1. Install the CLI

curl -fsSL https://get.vincia.io/install | bash
# or, if you prefer npm:
npm install -g https://get.vincia.io/cli/0.1.0/vincia-cli-0.1.0.tgz

2. Sign in

vincia login --token <vct_…>

3. Scaffold a design template

vincia create design-template my-template --build-type website
# or:
vincia create design-template my-portal --build-type portal
# add customer accounts:
vincia create design-template my-saas --build-type website --include-auth
# brand logo (optional — generates favicons + apple-touch + OG + monochrome):
vincia create design-template my-template --build-type website --logo ./logo.svg

Since CLI v0.3.0, design templates scaffold as an HTML/CSS folder package (with _common/ + website/ + portal/ + website-with-auth/subfolders). Swap design-template for theme, section-library, or ready-made-collection for the other foundation pieces.

4. Preview live

cd my-template vincia preview

Opens a local preview against multiple brand fingerprints. The URL it prints in the terminal is what you open in a browser.

5. Publish

vincia publish --dry-run

Runs the importer’s validators locally and prints the result. Drop the --dry-run to submit (LLM gate plus human review).

What’s next: read a guide for connectors, browse the API reference for the SDK surface, or join the community if you’re stuck.