Pictokiln docs
1. Finding icons
Open Pictokiln and pick where to look: the selection, the page or the whole file.
- Page and File take every component up to 256 px, including each variant of a component set. Bigger components (buttons, cards, screens) are skipped and counted.
- Selection takes the components, component sets and sections you select. With "Selected frames and groups count as icons" on, a selected frame, group or vector is an icon too, and a large frame full of small frames gives you its children.
The Icons tab draws each icon the way it will export and marks the ones with problems. Click one to select it in Figma.
2. Names
Names come from the layer name (the last part after a slash, or the full path if you choose "Full path"). Variants use the set's name plus their values: Bell with Size=24, Style=Outline becomes bell-24-outline; a property set to true adds its own name (Dot=true adds dot), and false, Default and None add nothing. Two icons with the same name get -2 and the check flags them.
| Output | Arrows/Arrow Right becomes |
|---|---|
| SVG files, CSS classes, sprite ids, catalog | arrow-right |
| React, Vue, Svelte components | ArrowRightIcon (the suffix is a setting) |
| Swift enum | Icon.arrowRight |
| Android drawable | @drawable/ic_arrow_right (the prefix is a setting) |
| Compose | AcmeIcons.ArrowRight (the object is named after the font) |
Names that start with a digit get an Icon prefix in code, and Swift and Kotlin keywords get an Icon suffix.
3. The check
The Check tab looks at the whole set. Problems don't stop an export; they show you what will look wrong in the files.
| Rule | What it means |
|---|---|
| Two icons with the same name | The second one is exported with -2. |
| Size outside the set's sizes | The icon isn't one of the sizes you list (16, 20, 24, 32 by default). |
| Size isn't a whole pixel, icon isn't square | Edges blur at 1x; fonts and most components expect square icons. |
| Points off the pixel grid | Vector points or layer edges that aren't on whole (or half) pixels. Turn the check off for illustrative sets. |
| Stroke weight differs from the set | Compared with the most common weight among icons of the same size. |
| Inside or outside stroke | SVG only has centred strokes; Figma exports these as masks or outlines. |
| Open path with a fill | The fill closes the shape with a straight line on export. |
| Text, pictures, shadows and blurs | Text should be outlined; pictures and effects don't survive fonts or native drawables. |
| Masks, hidden layers, several colours | Notes: masks are ignored by fonts and Android, hidden layers are left out, multi-colour icons keep their colours. |
Select them in Figma selects every layer with a problem. Download as CSV gives the list to the team.
4. Outputs
| Folder | What's in it |
|---|---|
svg/ | One optimized SVG per icon. Figma's frame clip is removed when it clips nothing, rectangles and lines become paths, simple transforms are baked into the path data, path data is written in its shortest form (3 decimal places by default), default attributes and unused ids are removed, and paths that can't overlap are merged. One-colour icons use currentColor. |
font/ | WOFF2, WOFF and TTF, a CSS file with a class per icon (.icon-arrow-right), a Sass map and codepoints.json. Glyphs are made from a copy of each icon with strokes outlined and shapes united, so line icons work. Each glyph fills the line height from the descender to the ascender. |
sprite/ | sprite.svg with a <symbol> per icon: <svg><use href="sprite.svg#icon-arrow-right"/></svg>. |
react/, vue/, svelte/ | npm packages (ES modules) with one file per icon and .d.ts types. Props: size (height; width follows the icon), title (makes it an accessible image), color, plus any SVG attribute. React needs 16.8 or later, Vue 3.2, Svelte 5. |
elements/ | A Web Component for the whole set: <acme-icon name="arrow-right" size="20" label="Next">, typed. |
ios/ | Icons.xcassets with an image set per icon (SVG, or single-page vector PDF if you choose PDF), vector data preserved, one-colour icons rendered as template images; and Icons.swift with Image(icon: .arrowRight). |
android/ | res/drawable/ic_*.xml vector drawables. One-colour icons are tinted with ?android:attr/colorControlNormal. |
compose/ | One Kotlin file with an ImageVector per icon for Icon(...). |
catalog/ | index.html: search the set, see what's new or redrawn, copy the snippet for each output. Works offline. |
Every export also writes CHANGELOG.md, icons.json (every name, code and Figma id) and a README.md with usage for the outputs you chose.
5. Font codes
Codes start at U+E001 in the private-use area. Each icon keeps the code it got the first time it was exported: matched by its Figma layer first, then by its name, so renaming an icon or rebuilding it under the same name keeps its code. A deleted icon's code is never handed out again, so an old stylesheet can't show the wrong icon. The codes are saved in the Figma file.
Moving from IcoMoon or another icon font? Before the first export, open Font codes on the Export tab and load the old selection.json (IcoMoon) or a {"name": code} file. Icons with the same names keep their old codes, and new icons are numbered after them.
6. Changes and versions
The Export tab compares the set with the last export from this file and lists icons added, removed, renamed and redrawn. The version follows semver: removals and renames are a major version (they break code that uses the old names), additions a minor version, redraws a patch. The first export is 1.0.0. The change list goes into CHANGELOG.md, the catalog's New and Redrawn filters, and the pull request.
7. GitHub pull requests
- Make a fine-grained personal access token at github.com/settings/personal-access-tokens/new: choose the repository, and set Contents and Pull requests to Read and write.
- On the Export tab choose GitHub pull request, enter the repository as
owner/name, the base branch (empty for the default branch) and the folder (for examplepackages/icons), paste the token and save it. - Click Open a pull request. Pictokiln uploads the files, makes one commit on a new branch (
icons/1.4.0-20261005-1312) and opens a pull request with the changelog.
Files in the folder that this export no longer writes (a deleted icon's SVG, for example) are deleted in the same commit. If the folder is the repository root, only files Pictokiln writes are touched.
The token is kept in Figma's plugin storage on your computer, never in the Figma file, and is sent only to api.github.com. Each designer saves their own. GitHub Enterprise Server isn't supported.
8. Trial and licenses
The trial is 7 days or 10 exports, whichever comes first, starting with your first export, each up to 100 icons. A ZIP or a pull request is one export. Finding icons, the check, previews and the change list are always free. After that, a license is $19 a month or $190 a year per person who exports. Enter your key under Plans and license key; one key covers as many seats as you bought, and each seat can be used on two Figma accounts.
9. Limits
- Up to 3,000 icons per export.
- Fonts and Android drawables draw each shape in one solid colour: gradients become their first colour, masks and effects are ignored. Multi-colour icons become one colour in the font.
- Text inside icons should be outlined in Figma first.
- The WOFF2 file is valid but not Brotli-compressed, so it's about the size of the TTF; for icon fonts that's a few kilobytes.
Questions: hello@greatwork.company. A person replies within one business day.