Lolly Beta
Launch App

ManageShared assets and provider connections

Penpot (kind: penpot)

Note: Lolly Work

This guide covers the optional organisation service. Configuration, console and API paths refer to your Lolly Work instance. The packaged console keeps its release-matched copy of this guide.

Connect a Penpot instance you host, and its design tokens flow into a Lolly Work design system while your designers keep working in Penpot. Boards stay in Penpot until a curator picks the ones worth keeping. Penpot remains the source of truth, and Lolly Work never writes to Penpot.

Penpot files split into two lanes: token sets federate on each sync into a design system that inherits them read-only, while boards are found by search and imported as catalog assets.Penpot files split into two lanes: token sets federate on each sync into a design system that inherits them read-only, while boards are found by search and imported as catalog assets.Open this in Diagram Builder

Design-system administration covers how token sources combine with the active design system.

What you need from Penpot

Credential shape

A single sealed string: the Penpot personal access token, sent as Authorization: Token ….

lw providers credential design-penpot     # prompts; never argv, never shell history

instance.json / lw providers add

{
  "id": "design-penpot",
  "kind": "penpot",
  "label": "Design Penpot",
  "options": { "baseUrl": "https://design.your-host.example", "teamId": "…", "format": "png", "scale": 2 },
  "mapping": { "typeMap": { "tokens": "tokens", "board": "image" }, "defaultType": "image" },
  "exposure": { "groups": ["design"], "tier": "reference" }
}
Options and mapping
SettingWhat it does
options.baseUrl (required)Your Penpot origin. Every call is pinned to this origin.
options.teamId, options.projectIdLimit which teams and projects are searched for files.
options.fileIdsRead exactly these files and skip the search.
options.formatHow imported boards render: png (default), svg, jpeg or webp.
options.scaleThe render scale for imported boards, default 1.
options.exporterUrlThe exporter's origin, when it differs from baseUrl.
mapping.typeMap (required)Maps Penpot's two types into the catalog: tokens to tokens (the design-system feed) and board to image (imported media). The console's Penpot card fills this in.

Verify

lw providers preview --kind penpot --options '{"baseUrl":"https://design.your-host.example"}'
lw providers health design-penpot

A penpot rpc get-profile <status> error means the instance URL or token is wrong, or the access-tokens flag is off.

Note: Not yet confirmed live

The RPC command and field names come from Penpot's documentation and are not yet confirmed against a live instance; a failed call reports the command (penpot rpc <cmd> <status>).

Notes / limits