Changelog

Quickly jump between Makeswift, BigCommerce, and Feedonomics docs

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.

Color control now supports object defaultValue

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

Example

1
import { Color, Style } from "@makeswift/runtime/controls";
2
3
runtime.registerComponent(Overlay, {
4
  type: "overlay",
5
  label: "Overlay",
6
  props: {
7
    className: Style(),
8
    overlayColor: Color({
9
      label: "Overlay color",
10
      defaultValue: { color: "#000000", opacity: 0.5 },
11
    }),
12
  },
13
});

Available since v0.28.6. For full documentation, see the Color control reference.

Multi-tenancy guides

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

For the full walkthrough, see the Multi-tenancy overview.

New Code control

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

Use cases

The Code control is ideal for components that need to display or process source code:

• Code snippet displays and syntax highlighters
• Custom script injection blocks
• Configuration or schema editors
• Embed code components

Example

1
import { Code, Style } from "@makeswift/runtime/controls";
2
3
runtime.registerComponent(CodeBlock, {
4
  type: "code-block",
5
  label: "Code Block",
6
  props: {
7
    className: Style(),
8
    snippet: Code({
9
      label: "Snippet",
10
      defaultValue: 'console.log("Hello, world!");',
11
    }),
12
  },
13
});

The control passes { value: string } to your component. If no value is set and no defaultValue is provided, your component receives undefined.

For full documentation, see the Code control reference.

New Makeswift Developer Docs

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.

What’s new

• Powered by Fern for a faster, more polished documentation experience
• Redesigned documentation site with improved navigation and search
• Dedicated API Reference tab for browsing REST API endpoints
• Changelog to keep you up to date with the latest changes