Reporter plug-in · Glyphs 3.5 and 4

A construction grid that follows the weight of your icons.

Draw with a wide field of square cells, two useful inner circles, spokes, and metric-fitted keylines. Set one construction unit per master and keep the rest simple.

License
Apache-2.0
Outlines
Unchanged
Saving
Never implicit
Glyphs 4 Edit view showing a lightbulb icon over the expanded stem grid and enlarged metric-fitted keylines.

Install · official listing in progress

Plugin Manager is the simplest option.

The GlyphsIconGrid listing is being reviewed in the official Glyphs package repository. Once the pull request is merged, Plugin Manager will be the recommended way to install and update the plug-in.

Alternative

Install the release manually

If Plugin Manager is not available yet or you cannot use it, download the latest release, unzip it, and double-click IconGrid.glyphsReporter.

After either installation method, restart Glyphs, open a glyph in Edit view, and choose View → Show Icon Grid.

Glyphs View menu with Show Icon Grid enabled.
One menu command shows or hides the reporter.
Default Glyphs master metrics with baseline 0 and cap height 700.
The default baseline-to-cap-height construction span is 700 font units.

Weight-matched setup · 1000 UPM

The grid follows the active master’s H stem.

Define weight-specific stems under Font Info → Masters → Stems. No IconGrid.gridSize parameter is needed: the same value controls square cells and the distance between up to two inner circles. The background grid extends at least four cells beyond the icon canvas.

Regular
84H stem
Bold
135H stem

These values come from the generic icon scaffold and are starting points. Use measured H stems for an existing design. For any master, x = (cap height − baseline) / H stem. Define Mid Height under Font Info → Masters → Metrics when the family has a master-specific construction center. When an unfiltered native Mid Height exists, the complete construction system centers on that position; otherwise it uses the baseline/cap-height midpoint. Mid Height overshoot is ignored, and an explicit IconGrid.baselineOffset still wins.

The live diameter remains (cap height − baseline) / 0.8: 875 units at the default cap height. The landscape keyline spans baseline to cap height when their midpoint is the construction center; a distinct Mid Height moves it without resizing it.

Grid phase

Odd is the default

In odd mode, one complete cell is centered on the horizontal and vertical construction axes. Use even only when grid borders must coincide with both axes.

Glyphs Edit view in odd grid mode, with a complete grid cell centered on each construction axis.
Odd: the axes bisect a complete central cell.
Glyphs Edit view in even grid mode, with grid lines coinciding with both construction axes.
Even: grid lines coincide with both axes.

Options

Master override, font fallback, built-in default

Each setting resolves independently. A valid active-master value wins, then a valid font value, then the built-in default. Disabled or invalid values fall through safely.

Normal setup

Use each master’s H stem. Set gridSize only for an intentional override.

Optional guides

The live area fits the cap height automatically. Store padding only for a custom cell-based inset; cadence, spokes, and keylines already have useful defaults.

Appearance

Color and opacity, with a blue default that stays distinct from Glyphs guides.

Automatic placement

Use each master's native Mid Height when available. Width, height, columns, rows, rings, origin, and baseline offset remain available for custom canvases.

Glyphs MCP

Inspect and change a font with your local AI client

Start Glyphs MCP with the Edit profile, connect to http://127.0.0.1:9680/mcp/, and install this repository’s Icon Grid skill. The skill identifies the font, previews changes, applies only confirmed values, reads them back, and leaves the font unsaved.

Glyphs MCP Server Status window with the Edit tool profile selected.
Use the local Edit profile for guarded parameter mutation.

Copy this request into your AI app

Use it after Glyphs MCP and the Icon Grid skill are installed. This is a read-only check: the AI explains the grid values without changing or saving the font.

Use $glyphs-mcp-icon-grid with the font open in Glyphs.

Check the grid size for each master.
Explain where each value comes from.
Do not change or save the font.

Expected explanation: when IconGrid.gridSize is not stored, the grid automatically uses each master’s H stem—84 for Regular and 135 for Bold in this example.

Double-click Install GlyphsIconGrid Skill.command in the unzipped release and choose the shared location. Then add the MCP server to ~/.codex/config.toml.

[mcp_servers.glyphs-mcp]
url = "http://127.0.0.1:9680/mcp/"

The MCP endpoint is local to your Mac. A browser-only AI session normally cannot reach 127.0.0.1.