Pictokiln docs

1. Finding icons

Open Pictokiln and pick where to look: the selection, the page or the whole file.

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.

OutputArrows/Arrow Right becomes
SVG files, CSS classes, sprite ids, catalogarrow-right
React, Vue, Svelte componentsArrowRightIcon (the suffix is a setting)
Swift enumIcon.arrowRight
Android drawable@drawable/ic_arrow_right (the prefix is a setting)
ComposeAcmeIcons.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.

RuleWhat it means
Two icons with the same nameThe second one is exported with -2.
Size outside the set's sizesThe icon isn't one of the sizes you list (16, 20, 24, 32 by default).
Size isn't a whole pixel, icon isn't squareEdges blur at 1x; fonts and most components expect square icons.
Points off the pixel gridVector points or layer edges that aren't on whole (or half) pixels. Turn the check off for illustrative sets.
Stroke weight differs from the setCompared with the most common weight among icons of the same size.
Inside or outside strokeSVG only has centred strokes; Figma exports these as masks or outlines.
Open path with a fillThe fill closes the shape with a straight line on export.
Text, pictures, shadows and blursText should be outlined; pictures and effects don't survive fonts or native drawables.
Masks, hidden layers, several coloursNotes: 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

FolderWhat'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

  1. 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.
  2. 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 example packages/icons), paste the token and save it.
  3. 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

Questions: hello@greatwork.company. A person replies within one business day.