v0.3.0

Postkit 0.3.0 — Bring your own design system

Postkit 0.3.0 separates portable content, component behavior, and presentation. Use headless React views with your own styles, keep Chakra’s styled components, or replace individual parts without forking the library.

What’s new

• Headless React: @postkit/react now provides headless views for all 38 built-in components, including interactive components. Style their shared anatomy with your own CSS or the optional token-based @postkit/react/styles.css baseline.
• Dedicated Chakra renderer: The existing styled components now live in @postkit/chakra. Recipes follow the host’s color mode, and PostkitHostProvider supports applications that already supply their own Chakra system.
• Composable configuration: createPostkit combines component kits, defaults, slot overrides, and custom views. Component definitions and the versioned manifest live in @postkit/core.
• Lazy rendering: Headless views load as they are rendered. Lazy Chakra and framework component maps, plus lazy document rendering, let pages download the views their content uses.
• Component ownership: The new @postkit/cli provides add, eject, diff, new, and manifest commands. @postkit/nx adds a component generator for Nx workspaces.
• Email rendering: renderEmail() converts Markdown, MDX, or a portable Postkit document into HTML and plain text, with explicit fallbacks for unsupported components.
• Footnotes and sidenotes: Portable footnotes work across web and email renderers, with configurable placement on the web.
• More publishing options: Experimental Device frames, peek carousels, row galleries, video captions, figure numbering, and configurable title heading levels.
• Astro renderer selection: Choose Chakra or headless views while keeping the same component anatomy and hydration policy.
• Syntax highlighting improvements: Shiki loads its core and JavaScript regex engine by default. Languages that haven’t loaded render as plain text.

This release also introduces the rebuilt Postkit website, expanded documentation, live component previews, and accessibility improvements across the renderers.

Migrating from 0.2

@postkit/react now means headless React. For the existing Chakra components, replace the dependency and imports:

// Before
import { Callout, PostkitProvider } from '@postkit/react';

// After
import { Callout, PostkitProvider } from '@postkit/chakra';

Update /theme, /remark, and /document imports to use @postkit/chakra too.

Components now default to the subtle variant. Set variant="outline" directly or through component defaults to retain the outlined appearance.

When using createPostkit, configure Markdown compilation with postkitRemarkPlugins from @postkit/react/remark. Remark tooling stays outside the client rendering configuration.

Full Changelog: v0.2.0...v0.3.0

v0.2.0

What's Changed

• v0.2.0 by @ryanhefner in #2

New Contributors

• @ryanhefner made their first contribution in #2

Full Changelog: v0.1.0...v0.2.0

Postkit v0.1.0

Full Changelog: https://github.com/postkit-org/postkit-js/commits/v0.1.0