Guidelark docs

1. Reading your library

Open Guidelark in your library file and pick what to document: the whole file, this page or the selection (components, component sets, or a section or frame that holds them). Selecting one variant documents its whole set.

2. What goes on a component page

On the pageFrom Figma
IntroductionThe component description, with bold, italics, lists, inline code and links. Links in it must start with https://, http:// or mailto:.
LinksThe documentation links on the component (Figma's "Add link" in the properties panel)
PreviewA picture of the default variant (the first one in the set)
UsageDo, Don't and Caution frames (see below)
PropertiesEvery component property: variant, boolean, text, instance swap and slot, with its default, options and description
VariantsTables with a picture of every variant. The first variant property runs down the side, the second across the top, and there's a table for each value of the rest (up to 16 tables). Combinations that don't exist are empty cells.
SpecsThe default variant's size, auto layout direction, padding and gap, corner radius, and every variable and style it uses (with the layer and what it's used for)
NotesDev Mode annotations on the component and its default variant, with their category and the values they pin

3. Do and Don't examples

Name a frame, section or group Do, Don't, Caution or Avoid, with an optional caption after a colon: Do: Use one primary button per view. Without a caption, the first short text inside the frame is used. Guidelark links each one to a component:

Frames it can't link are listed under "Before you export" on the Library tab.

4. Tokens and styles

Each variable collection gets a page with every mode as a column, so Light and Dark (or brands, or densities) sit side by side. Colours get swatches, spacing and size numbers get bars, radii get a rounded corner, and aliases show the variable they point to under the resolved value. The CSS column uses the variable's web code syntax when you set one (var(--acme-primary)), otherwise a name made from its path.

Every export also includes, in data/:

Variables from another library show by name, since their values live in that library's file.

5. Formats

FormatWhat you get
Static websiteindex.html, a page per component, collection, styles and the changelog, pictures in img/, search, light and dark themes. Relative links: open it from a folder, or upload it to GitHub Pages, Netlify, Cloudflare Pages, S3 or any web server. Set the title, introduction and accent colour on the Export tab.
DocusaurusMDX pages with front matter and _category_.json sidebars. Put the folder inside your docs/ directory; index.mdx becomes the category's page.
StorybookMDX docs pages with <Meta title> under the sidebar folder you choose, pictures imported so your builder bundles them. Pick Storybook 9 or later, or 8.
MarkdownPlain GitHub-flavoured Markdown with pictures, README.md as the overview and CHANGELOG.md. Colour swatches are small SVG files, because GitHub strips inline styles.

Pictures render at 2x by default. Turn off "A picture of every variant" or choose 1x for big libraries: pictures are the slow part of an export.

6. Versions and the changelog

Each export compares the library with the last export from this file and picks the next version:

The first export is 1.0.0. An export with no changes keeps the version. The Changes tab shows the list before you export. The history is saved in the Figma file, so whoever exports next continues the same changelog.

7. GitHub pull requests

Choose "GitHub pull request" on the Export tab and enter the repository (owner/name), the base branch (empty means the default branch) and the folder, for example docs/design-system. Then make a fine-grained personal access token at github.com/settings/personal-access-tokens/new for that repository with Contents and Pull requests set to Read and write, paste it and click Save token.

Each export makes a branch like docs/1.2.0-20261007-1500, commits the docs and opens a pull request with the change list. Files in the folder that the export no longer writes (a deleted component's page) are deleted in the same commit. At the repository root only files Guidelark writes are touched. The token stays in Figma's storage on your computer and goes only to api.github.com.

8. Trial and plans

The trial gives you 10 exports over 7 days, starting with your first export, up to 25 components each (document a page or a selection to stay under it). A ZIP or a pull request is one export. Reading the library, the gap list and the change list are always free. Then $59 a month or $590 a year per person who exports; readers need nothing. Enter your license key under Plans and license key.

9. Limits

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