everettjf /scriptwidget
Write native widgets for iPhone, iPad, Mac and Android in JavaScript and JSX. Open source, with a browser studio, templates and AI.
★ 299⑂ 44👁 4⑃ 67● 9▤ 8
299
stars
44
forks
4
watchers
67
prs
9
issues
8
releases
README
ScriptWidget 🎨
使用 JavaScript、JSX 和 AI,为 iPhone、iPad、Mac 与 Android 创建原生 Widget
English | 简体中文 | Español | 日本語 | 한국어 | Français | Deutsch | Português | Русский | العربية
用你的 Agent 创作 — scriptwidget-creator
在 Claude Code 描述组件,让 Agent 生成、校验,并直接打开 Web Studio 查看效果。 沿用自己的 Agent 和模型,安装官方 Skill到 ~/.claude/skills/scriptwidget-creator/,使用 /scriptwidget-creator 调用。
sh
brew install everettjf/tap/scriptwidget-cli
scriptwidget preview ./MyWidget
生成后自动打开并加载,不需要手动导入。组件通过 URL 片段传递,不需要上传服务器;加载成新项目并清除地址栏中的包数据。链接容量为压缩包 45 KB,大包可使用原生预览或 .swt 导入。链接包含代码与资源,私有组件不要分享链接。
完整安装与使用说明 · Creator 专页 · CLI 文档
!ScriptWidget 模板画廊
ScriptWidget 是一个 Apache 2.0 开源的 Widget 创作平台。你不需要学习 Swift:在 Mac Studio、iPhone 或 iPad 上编辑 main.jsx,运行时会把声明式 JSX 映射为原生 SwiftUI/WidgetKit 界面。
Android 版(1.0.0,要求 Android 15 或更高版本)已在 GitHub Releases 提供 APK。Google Play 版正在封闭测试:先加入 Atomsprout Testers 群组,再成为测试者,然后从 Google Play 安装。与 iOS 的差异详见 Android 版 ScriptWidget。
为什么选择 ScriptWidget
- 一份脚本适配 iOS、iPadOS 与 macOS,以及 Android,多尺寸布局可通过 $getenv("widget-size") 调整。
- 支持交互式 Widget、App Intents、Live Activity、灵动岛与 Control Widget。
- Mac Studio 内置 CodeMirror 编辑器、补全、诊断、Console 和多尺寸预览。
- 可用 OpenAI 兼容模型生成、运行、诊断并迭代 Widget;API Key 保存在 Keychain。
- Widget & Skills Gallery 支持经过索引、大小、路径与 SHA-256 验证的一键安装和离线缓存。
- 70 个内置模板、版本化 Runtime API、Package 2.0 与 Skills 1.0 均有自动测试和发布门禁。
五分钟开始
bash
git clone https://github.com/everettjf/ScriptWidget.git
cd ScriptWidget
open macOS/ScriptWidgetMac.xcodeproj
或:open iOS/ScriptWidget.xcodeproj
在 Xcode 中选择 ScriptWidgetMac 或 ScriptWidget scheme,配置 iCloud.ScriptWidget container 与 group.everettjf.scriptwidget App Group,然后运行。也可以直接按照五分钟教程创建第一个 Widget。
Android 版改用 Gradle 构建(需要 JDK 17 或更高版本和 Android SDK;应用要求 Android 15 或更高版本):
bash
cd Android && ./gradlew :app:assembleDebug
最小脚本:
jsx
$render(
Hello, ScriptWidget!
);
文档
- 文档中心
- 从零创建第一个 Widget
- ScriptWidget Studio
- Runtime API
- AI 生成
- Widget & Skills Gallery
- Package 2.0 与 Skills 1.0
- 公开路线图
参与贡献
欢迎提交 Runtime、Mac/iOS 体验、模板、Gallery Widget、AI Skill、测试与文档。请先阅读贡献指南、治理规则和行为准则,并在提交前运行:
bash
./Scripts/release-readiness.sh
Android 应用有独立的构建和测试,上面的门禁不包含它:
bash
node Android/scripts/build-shared-js.mjs after changing Web/preview-engine/src
cd Android && ./gradlew :core:testDebugUnitTest :app:assembleDebug
sh scripts/device-test.sh core instrumented tests on a connected device
sh scripts/device-test.sh app
详见 Android 版 ScriptWidget、测试说明和待办事项。
安全问题请按照安全政策私下报告,不要在公开 Issue 中披露利用细节或个人数据。
ScriptWidget 仓库中的源代码使用 Apache 2.0 License 发布。
ScriptWidget 名称、Logo、截图与 App Store 商店宣传素材不包含在 Apache 2.0 许可范围内;这些品牌及宣传资产的权利归各自权利人所有。
Discord
正在开发的系统能力
Runtime 1.6 新增通知提醒、健康历史、日历写入、天气、闹钟、文件导入、联系人、地图和 HomeKit。每个组件独立授权,Web Studio 提供隔离的模拟数据。API 文档、九个示例及真机验收清单。当前仍需完成真机验收后再发布。Latest release
ScriptWidget 27.2.6 for iPhone, iPad and Mac v27.2.6 2026-11-17ScriptWidget 27.2.6 for iPhone, iPad and Mac, released on the App Store on 15 November 2026. What's new - Updated the product, support and privacy links, the contact email and the copyright information for AtomSprout. - Added email feedback that includes the app version and basic system information. Download - iPhone and iPad on the App Store - Mac on the App Store The Apple apps are distributed through the App Store only, so this release has no files attached. For Android, see ScriptWidget for Android 1.0.0.