@instructure/platform-components

Shared presentational components for platform-ui packages.

What this is

This package is a pilot program. Components here are built the way InstUI itself builds components — the same architecture, the same theming system, the same accessibility bar — with the goal of graduating proven ones into InstUI for wider use. Until (if) that happens, treat everything here as experimental.

Accessibility and design review follow InstUI's own process, just accelerated — a component belongs here only if it would pass InstUI's actual bar, not a lighter one. What genuinely differs is the release contract: this isn't a stable design-system package yet. Breaking changes can land here more often than you'd expect from something under the @instructure scope, because these components are still being proven out. Pin versions and read changesets before upgrading.

What belongs here

Shared presentational components. Anything with its own data fetching or domain logic gets its own package instead — see docs/adr/shared-components.md.

Components

Run pnpm storybook for the current component catalog — usage examples, prop tables, and each component's design rationale live there, generated from source, so they can't drift out of sync with the code the way a hand-maintained list here would.