ScriptWidget Documentation
Build native widgets for iPhone, iPad, and Mac with JavaScript and JSX. The quickest path is Your first widget.
- Your first widget — create, preview, debug, and install a widget.
- Five-minute tutorial — the built-in first-launch walkthrough and its complete workflow.
- ScriptWidget Studio — Mac editor, multi-size preview, Copilot, and Skills.
- Runtime API — supported components, properties, globals, and limits.
- AI generation — provider setup, prompting, iteration, privacy, and troubleshooting.
- Apple PCC AI plan — feasibility, constraints, architecture, and zero-key rollout.
- Skills 1.0 — reusable AI guidance, authoring, safe sharing, and package format.
- Widget & Skills Gallery — discover, verify, install, update, and submit community packages.
- Data Source Plugins — safe third-party API connectors and the Mac Data Source Lab.
- Package 2.0 — widget.json, compatibility, and secure imports.
- Modern WidgetKit features — rendering modes, Live Activities, controls, intents, and push updates.
ScriptWidget focuses on iOS, iPadOS, and macOS. A single main.jsx can adapt its layout with $getenv("widget-size"). watchOS and visionOS are outside the current roadmap.