Changelog

Placeholder changelog entry

This is a placeholder entry for the developer changelog. Replace this with actual release notes.

New REST API endpoints for site management

We’ve added new API endpoints that give you programmatic control over site configuration, deployments, and component registration.

New endpoints

• POST /api/v2/sites/{siteId}/deploy — Trigger a deployment
• GET /api/v2/sites/{siteId}/deployments — List deployment history
• PUT /api/v2/sites/{siteId}/settings — Update site settings
• GET /api/v2/components — List registered components

Breaking changes

None. All new endpoints are additive.

SDK v4.0 release

Makeswift SDK v4.0 is now available with TypeScript-first APIs, improved component registration, and better Next.js App Router support.

Highlights

• TypeScript-first — All APIs are now fully typed with generics support
• New registerComponent API — Simplified component registration with better prop type inference
• App Router support — First-class support for React Server Components and the Next.js App Router
• Smaller bundle — 35% reduction in client-side JavaScript

Breaking changes

• Dropped support for Next.js 12 and below
• MakeswiftProvider has been renamed to MakeswiftRoot
• The runtime prop on page components has been removed in favor of automatic detection

See the migration guide for details.

Rate limiting and API key scopes

API keys now support granular permission scopes, and we’ve introduced rate limiting to ensure platform stability.

New features

• Scoped API keys — Create keys with read-only, write, or admin permissions
• Rate limit headers — All responses now include X-RateLimit-Remaining and X-RateLimit-Reset headers
• Usage dashboard — Monitor your API usage in the Makeswift dashboard

Rate limits

Webhook support for build and deployment events

You can now subscribe to webhooks for real-time notifications about builds, deployments, and content changes.

Supported events

• deployment.started — Fired when a deployment begins
• deployment.completed — Fired when a deployment succeeds or fails
• content.published — Fired when a page or content entry is published
• content.unpublished — Fired when content is taken offline

Configuration

Webhooks can be configured in your project settings or via the API. Each webhook supports custom headers for authentication and filtering by event type.

Custom prop controls for the visual editor

The SDK now supports building custom prop controls, letting you create tailored editing experiences for your components.

What’s new

• createPropControl API — Define custom input UI for component props
• Validation support — Add client-side validation rules to your controls
• Nested controls — Compose controls together for complex data structures

Example

1
import { createPropControl } from "@makeswift/runtime";
2
3
const ColorGradient = createPropControl({
4
  type: "color-gradient",
5
  label: "Gradient",
6
  render: ({ value, onChange }) => (
7
    <GradientPicker value={value} onChange={onChange} />
8
  ),
9
});