Merging libraries

I wanted to export the carbon design system to penpot, so I exported page by page of the carbon design system to penpot. I could not export the whole project. And now I want to merge all those pages in one library but i am not getting it. Any ideas how I can do it?

@Ricardo_Harano_Pinto I’m not sure if I entirely understand what you’re trying to do. Are you saying that you have multiple Penpot files each containing a page of the Carbon design system that you want to merge into one file with multiple pages? Could you copy paste the pages into one file to create the library?

I’m sure we can find a way to do what you need!

@LauraKalbag I think what’s happening here is that Ricardo is trying to move the Carbon design system from Figma to Penpot using the Penpot Exporter plugin. The file is simply too large, so the export aborts and never finishes.

That’s why he ended up exporting page by page as separate .penpot files — and now has the problem of merging them back into a single library.

@Ricardo_Harano_Pinto Vibe-coded a tool for exactly this use case, merging multiple .penpot exports into one library file: GitHub - girafic/penpot-file-merger: Merges several `.penpot` exports into a single library file, on the ZIP level — no Penpot instance, no plugin API, no browser. · GitHub

Inside Penpot there’s no way to combine the files (the plugin API can’t move content between files, and copy-paste loses component links and tokens), so the tool works directly on the .penpot ZIP archives instead. Components (including variant sets), colors, typographies and design tokens all survive the merge. I tested it with your exact scenario: the full Carbon Design System merged from 4 Figma exports — 29 pages, ~170k shapes, 2,417 components and 7,140 design tokens — imports fine into penpot.app.

Also, since exporting page by page is painful: I’ve opened a PR for the Figma exporter plugin that adds a “Choose pages” export scope, so you can export several pages per file in one go: Feature page selection for export by girafic · Pull Request #403 · penpot/penpot-exporter-figma-plugin · GitHub

One heads-up for large files (100 MB+): Penpot’s import dialog may show “Something went wrong while processing this file” even though the import actually succeeds — the progress stream times out while the backend keeps working. Check your drafts before retrying; the file is usually there, complete.

Hope that helps!

2 Likes