Changelog

The sidebar navigation now shows availability badges, making it easier to spot the status of a page before you open it.

• Beta and deprecated indicators — pages marked beta or deprecated now surface that status directly in the sidebar.
• Faster scanning — identify pre-release and legacy content at a glance while browsing the navigation.

Apps are out of Early Access and available to everyone. You no longer need to enable an early access setting before creating an app to authenticate with the Makeswift REST API.

• No setup required — head straight to Settings → Workspace → Apps to create an app and get your API key.

For details, see Authentication.

The IconRadioGroup control adds an icon-based radio group panel to the Makeswift builder, letting developers offer visual icon options for component properties like alignment, layout direction, or style variants.

• Kebab-case icon values — Pass icons as bare strings (e.g., "text-align-left", "arrow-right") or use the IconRadioGroup.Icon accessor
• 169 built-in icons — Full set of icons covering alignment, arrows, layout, logos, and more
• Typed generic prop — The control passes the selected option’s value as a typed string to your component

We’ve added a dedicated AI Agent Setup page that walks you through connecting the Makeswift developer docs to your AI tool — so it can answer questions grounded in our documentation instead of guessing.

• One-click install for Cursor and Claude Code via the Copy page dropdown in the upper-right of any docs page
• Manual setup snippets for Cursor, Claude Code, Codex, and Claude Desktop
• Bottom-pinned sidebar link on every tab so the page is reachable from anywhere on the site

Thanks to your feedback, the header logo is now a site switcher. Click the logo at the top-left of any page to open a dropdown and jump straight to the BigCommerce or Feedonomics docs without leaving your tab.

Keep the feedback coming.

The Color control now accepts an object with color and opacity fields for its defaultValue, making it easy to set semi-transparent defaults directly in your component registration.

• Object form defaultValue — Pass { color: "#000000", opacity: 0.5 } instead of a plain color string to define a default with transparency
• Resolved RGBA string — The control still passes a single RGBA string to your component, so no changes are needed in your component code
• Backward compatible — Plain CSS color strings (e.g., "black", "#4f46e5") continue to work as before

New guides walk you through serving multiple Makeswift sites from a single Next.js application using tenant-specific Site API keys.

• Subdomain-based routing — Route tenants with subdomains like siteA.example.com
• Path-based routing — Route tenants with URL path prefixes like example.com/siteA, with subdomain support for the Visual Builder

The Code control adds a full-featured code editor to the Makeswift builder, giving content teams a professional editing experience for source code snippets.

• Monaco-powered editor — Opens an editor in a dialog using the same engine that powers VS Code, with syntax highlighting, line numbers, and familiar keyboard shortcuts
• Automatic language detection — The editor detects the language from content automatically, covering JavaScript, TypeScript, HTML, CSS, JSON, YAML, Python, Go, Rust, SQL, shell, and many others
• Standard control interface — Follows the same pattern as other controls with label, description, and defaultValue options

We’re excited to announce the launch of our brand-new documentation site, now powered by Fern! The new docs feature a refreshed design, improved navigation, and a dedicated API Reference tab for the Makeswift REST API.