Penpot Bridge brings Penpot designs into Roblox Studio as editable UI where supported, with image fallbacks for complex artwork. Select a layer, group or board in Penpot, prepare it, send it to Studio, review the changes and import.
Send the same selection again to update an existing import, preserving compatible instances and local edits unless you explicitly choose to replace them.
Install the Studio plugin · Download the Windows helper · Documentation and source
Current release: 3.0.0 for both the helper and Studio plugin. Both interfaces have been redesigned with clearer navigation, light/dark preferences and import progress. This release also adds native support for compatible circular and elliptical gradients, alongside improved linear-gradient placement.
What can it import?
-
Editable Roblox UI: supported frames, text, buttons, strokes, corners, gradients and layouts become native Instances.
-
Text formatting: supported mixed-style text becomes RichText. You can choose a native font weight per layer, while keeping the Penpot weight as the default.
-
Complex artwork: vectors, images and unsupported effects can use transparent image surfaces while retaining the surrounding editable UI.
-
Layouts: supported rows and columns can use native layouts. Native uniform grids are an optional toggle; unsupported layouts keep their measured positions.
-
Gradients: compatible linear, circular and elliptical fills remain editable. Unsupported gradient geometry retains an image fallback. No Studio beta setting is required.
Control what gets imported
In Penpot, the companion separates Transfer, Layers, Images and Settings. Search for a layer to choose Auto, Native, Image, Layout only, Skip subtree or Reusable template. Optional button suggestions can identify clear names such as UpgradeButton; you decide whether to accept them.
The Images page lets you select an eligible surface, adjust tint/glow options or drag its nine-slice guides, and check stretch previews before applying. Opposite borders can be linked, and each image keeps its own pending edits.
In Studio, Review shows planned changes and conversion-quality notes before import. Progress follows the actual import, and the completion screen reports its results. The separate Verify page runs read-only checks for missing objects, property differences, image references, text overflow and unexpected overlaps.
Templates, gameplay references and design tokens
-
Reusable Studio templates: map one of your existing UI components to a key, then use that key on a Penpot layer. The importer clones your component’s appearance, children and scripts while using the design’s placement.
-
Gameplay references: optional stable references help your own scripts find imported UI after renaming or moving it. Importing a button does not generate its upgrade, purchase or other gameplay logic.
-
Design tokens and themes: supported token bindings and aliases can be retained, with an optional runtime theme module your game can call.
See the feature guide for supported combinations, examples and limitations.
Getting started
There are three parts: the Studio plugin, the Penpot companion and a local helper that connects them. Installing the Studio plugin alone does not install the other two.
| Part | When you need it |
|---|---|
| Local helper | Keep it running while installing/opening the Penpot companion and transferring designs, including designs without images. |
| Roblox Assets Read/Write key | Only when new image assets need the helper’s upload fallback. It is not required just to install, connect or transfer native UI. |
The portable helper is for Windows x64 and includes Node.js. For other systems, see running from source.
- Install Penpot Bridge from the Creator Store.
- Download PenpotBridge-Windows-x64.zip, extract the entire ZIP, and run Start-Penpot-Bridge.cmd. Keep its command window open.
- Open helper status. You can leave optional image-upload setup closed and continue without a key.
- In Penpot’s Plugin Manager, install
http://127.0.0.1:43129/manifest.json, approve its requested permissions, and open Penpot to Roblox. - Select a layer, group or board. On Transfer, click Prepare selection, then Send to Studio. Apply any pending image edits before sending.
- In Studio, open Plugins → Penpot Bridge, then choose Receive from Penpot → Review import → Import design. If new images need uploading, the final action reads Upload images & import.
If Studio asks to contact 127.0.0.1, that address is the helper on your own computer. Allow the connection to transfer designs. Preparing alone does not send anything to Studio.
You can close the helper’s browser status tab; its command window must stay running. Start the launcher again after restarting your PC. Your finished game needs neither the helper nor an upload key.
Optional image uploads
Image assets include PNG fallbacks for some fonts, vectors, gradients and effects, not just photos. Previously uploaded images can be reused.
Set up image uploads when your import needs them
- In Roblox Creator Dashboard, create a dedicated Open Cloud key with Assets Read and Write permissions for the intended account or authorized group. Use an owner you are allowed to upload for in Studio.
- Save the key securely, for example in a password manager. You can reuse it after restarting the helper while it remains valid and has the required permissions.
- Open helper setup, enter the key locally, and click Enable image uploads.
- Return to Studio and continue the reviewed import.
The helper keeps the entered key in memory and sends it only to Roblox for validation and uploads. Stopping the helper clears it. Keep keys out of screenshots, forum replies and bug reports. Roblox’s API-key guide explains permissions and restrictions.
What to expect
Conversion is not guaranteed to be pixel-perfect. Font availability, text metrics, shadows and gradients can differ from Penpot. Image mode can preserve baked artwork, but that artwork is edited in Penpot and re-exported. The verifier checks objects and properties; it does not compare screenshots or inspect text baked into images.
The workflow focuses on desktop UI. It does not automatically redesign your interface for mobile. Review important imports visually before using them in your game.
The helper transfers prepared designs and processes image surfaces locally. There is no Penpot Bridge account or hosted relay required, and no third-party Roblox account connection. Penpot still uses your chosen Penpot service, and image uploads go to Roblox, where its permissions, moderation and limits apply.
The project is MIT-licensed. Incorporated third-party code is credited in the notices.
Help and feedback
If Penpot cannot install the plugin or Studio cannot connect, first check that helper status opens. The manifest URL only works while the helper is running on that computer.
- Interface guide: where to find controls in both plugins.
- Troubleshooting: installation, connections, image uploads and duplicate copies.
- Release notes: changes and validation for 3.0.0.
Feedback from real designs would be useful, especially on conversion quality and setup clarity. Suggestions are welcome, and reproducible bugs can be reported through GitHub Issues. Include the helper/plugin versions, full error and a small example you are comfortable sharing publicly.
Development note: Penpot Bridge was made with AI. The project is free and open source, and anyone is welcome to inspect the code, modify it, or contribute improvements.

