@ios27_design_system/metadata

Written specifications for the iOS 27 / iPadOS 27 design system — 36 component specs, 5 templates, 5 sections, and 48 page recipes, as Markdown.

This package carries no code. It is the prose layer that explains what the numbers in @ios27_design_system/tokens mean: how a tab bar is assembled, which measurements are kit-attested, where iOS 27 departs from iOS 26. Markdown so that both people and coding agents can read it.

npm install @ios27_design_system/metadata

Contents

| Path | Count | What it holds | |---|---|---| | components/specs/ | 36 | Per-component specs — tab bars, sidebars, toolbars, sheets, alerts, buttons, pickers, and the rest | | templates/ | 5 | Whole-screen structures | | sections/ | 5 | Regions of a screen — status bar, content, system, overlay | | pages/iphone-examples/ | 25 | iPhone page recipes | | pages/ipad-examples/ | 23 | iPad page recipes |

Reading a file

import spec from '@ios27_design_system/metadata/components/tab-bar';
import page from '@ios27_design_system/metadata/pages/iphone/settings-screen';

Subpath exports resolve to the Markdown files, so bundlers configured for raw imports and agent toolchains reading from node_modules both work. Reading from disk is equally fine:

import { readFileSync } from 'node:fs';
readFileSync('node_modules/@ios27_design_system/metadata/components/specs/tab-bar.md', 'utf8');

Available roots: components/*, templates/*, sections/*, pages/iphone/*, pages/ipad/*.

Provenance

Specs cite the Figma node they were measured from, against Apple's official iOS 27 UI Kit 27.0.2. Where a value could not be attested by the kit, the file says so rather than substituting a guess — some measurements are carried over from the iOS 26 extraction and are marked as such, and a few kit defects are recorded alongside the corrected value and its source.

Read the caveat in a spec before treating its number as authoritative.

License

MIT for this package's text. Apple's design resources are Apple's, licensed separately, and are not included here or in the repository.

Repository