Platform setup

Pick a surface. Desktop is the fastest feedback loop; native extensions take longer but ship on the home screen.

Platform	Surface	Rough time	Guide
Desktop	Frameless webview	~10 min	Desktop · First widget
Android	Jetpack Glance AppWidget	~30–60 min	Android
iOS	WidgetKit extension	~1–2 h (Xcode)	iOS
macOS	WidgetKit .appex + tauri build	~1–2 h	macOS
Windows	Widgets Board and/or desktop webview	~1 h	Windows
Linux	Desktop webview + X11 pin	~30 min	Linux

Before any Apple surface (including desktop webview on a Mac): add plugins.widgets.appGroup — Install. CLI scaffolds do not write it.

Each setup page ends with When it fails. Symptom index: Troubleshooting.