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.
- Web Studio in the browser — design and preview on Windows, macOS, or Linux, then install on iPhone.
- Runtime API — supported components, properties, globals, and limits.
- AI generation — provider setup, prompting, iteration, privacy, and troubleshooting.
- AI quality testing — bounded live generation, native snapshots, offline replay, and visual review.
- 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.
- Runtime API contract — versioning and compatibility policy.
- Studio architecture — editor and bridge design.
- Browser widget preview research — browser-first fast preview proposal, fidelity model, and staged validation plan.
- Browser preview engine — engine, renderer, measured JavaScriptCore and SwiftUI parity (iOS and macOS), sandbox isolation, and known differences. The macOS comparison app lives in
Tools/ScriptWidgetPreview. - Browser preview coverage — generated per-tag and per-property support matrix.
- Release readiness — platform and quality checklist.
- Contributing — repository workflow and contribution guide.
- Roadmap, governance, and changelog — direction, decisions, and shipped work.
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.