NextGuide Add-ons

Components & themes

How NextGuide will render add-on UI, MDX blocks and themes without trusting arbitrary package code.

Components, MDX and themes

We want add-ons to support real components and integrations, not just Markdown files. Today the framework provides a safe, data-driven UI foundation; running third-party React/TypeScript add-ons is still a separate milestone.

Not a downloadable executable add-on yet

These APIs are part of the NextGuide source implementation. The private registry still accepts content-only v1 archives and cannot install code-bearing v2 bundles. Don't attempt to bundle JavaScript in a v1 content directory.

Describe a view

NextGuide already has a host-owned renderer for a limited set of JSON UI nodes. It uses NextGuide UI components, rather than arbitrary HTML.

Safe UI descriptorJSON
{
  "type": "card",
  "children": [
    {
      "type": "heading",
      "level": 2,
      "text": "Search settings"
    },
    {
      "type": "paragraph",
      "text": "Control which pages appear in search results."
    },
    {
      "type": "badge",
      "text": "Preview"
    },
    {
      "type": "button",
      "text": "Configure",
      "action": "open_settings"
    }
  ]
}

Render with NextGuide

Preview

Search settings

Control which pages appear in search results.

Preview
Trusted site integration (not marketplace install)TypeScript (TSX)
import { ExtensionView } from "nextguide/extensions/ui"

const view = {
  type: "card",
  children: [
    { type: "heading", level: 2, text: "Search settings" },
    { type: "paragraph", text: "Choose which pages appear in search." }
  ]
}

export default function SearchSettingsPreview() {
  return <ExtensionView view={view} />
}

Currently supported descriptors include text, headings, paragraphs, badges, links, buttons, dividers, stacks and cards. Action identifiers must be handled and authorized by the host. Descriptors cannot contain raw HTML, JSX, scripts or injected React callbacks.

Next milestones

CapabilityRequired boundary
Custom React componentsIsolated browser execution and controlled host messaging
MDX blocksVerified rendering adapters with permissions
Themes & icon packsReviewed assets and scoped style tokens
Admin pagesProtected host navigation and capability-approved actions
Server endpoints & jobsIsolated process runtime, explicit requests and resource limits

See Extension API and Permissions & security.