iOS Scriptable Widgets

Home-screen widgets for Scriptable, written in plain JavaScript. No API keys, no subscriptions, no companion app — paste a file into Scriptable and put it on your home screen.

---

The widgets

Widget	Size	What it does
MonthPulse	Medium	Greeting, today's date, month progress as a day-by-day pip timeline, weather, and today's events and reminders. Accent colour sampled from your wallpaper.

Install

Same three steps for every widget here.

1. Get Scriptable. Free on the App Store. Nothing else to buy.
2. Add the script. Open Scriptable → + → paste the widget's .js file → tap the settings icon and name it exactly as the widget's README says. Some scripts build their own tap URL from the script name, so the name matters.
3. Add the widget. Long-press the home screen → + → Scriptable → pick the right size → place it → long-press the placed widget → Edit Widget → Script → choose your script.

Run the script once inside Scriptable first (▶). That's where permission prompts — location, calendars, reminders, photos — appear; a widget can't ask for them on your behalf.

Each widget's folder has its own README with configuration, tap actions, and the things it can't do.

Updating a widget

Scriptable has no update channel. Copy the new file contents over the old script body; your widget placement and its Parameter field survive. Anything you changed inside the CONFIG block does not, so keep a note of it.

Repo layout

<WidgetName>/
  <WidgetName>_Widget.js   the script you paste into Scriptable
  README.md                configuration, tap actions, limitations
  screenshots/
assets/                    repo-level graphics
tools/render-readme-images.mjs   regenerates the README images (needs Chrome)

The README images are mock-ups rendered from HTML rather than device captures, so they stay consistent as widgets are added. node tools/render-readme-images.mjs rebuilds them.

Licence

MIT. See LICENSE.