Welcome

Widget collection preview

Scriptable iOS Widgets is the official handbook for every widget in this repository. You will find installation steps, configuration tables, troubleshooting tips, and links back to the source code so you can confidently run each widget inside the Scriptable app.

Overview

This documentation focuses on clarity and repeatable setup:

• Summaries of every widget and the problem it solves.

• Step-by-step onboarding for Scriptable newcomers.

• Centralized references for API keys, Google Sheets templates, and configuration parameters.

• Community and support links collected in one place.

Quick Links

Section	Purpose	Link
Widget Library	Full catalog with screenshots and feature tables	Browse widgets
Installation	Device prerequisites, Scriptable basics, widget deployment	Installation guide
Contributing	Coding standards, review flow, issue templates	Contributing
Media Reference	Image inventory for GitBook previews	Asset list

Spotlight Widgets

Widget	Primary use case	Reference
Weather	Minimal snapshot of current conditions with theming and location awareness	Weather widget
AQI	Air quality and temperature monitoring powered by OpenWeather	AQI widget
Countdown	Event boards synchronized through Google Sheets	Countdown widget
GitHub Stats	Personal GitHub analytics and contribution tracking	GitHub stats widget
Birthday	Precision age tracking with milestone reminders	Birthday widget
Quote	Daily inspirational quote rotation with theme support	Quote widget

Visit the complete library to review every widget, learn about prerequisites, and copy the corresponding Scriptable files.

Get Started in Minutes

1. Install Scriptable from the iOS App Store and grant necessary permissions (location, calendar, etc.).

2. Pick a widget from the library and read its guide end-to-end.

3. Copy the JavaScript file into Scriptable and add required configuration (API keys, parameters, or Google Sheets links).

4. Run the script inside Scriptable to validate network calls and formatting.

5. Add the widget to the home screen, set its parameter string, and verify refresh behavior.

Why Teams Use These Widgets

• Actively maintained: scripts receive iterative updates as APIs or iOS behaviors change.

• Well documented: every widget page includes prerequisites, configuration tables, and troubleshooting sections.

• Customizable: colors, layouts, data sources, and refresh intervals are exposed via constants or parameters.

• Efficient: careful data fetching keeps battery impact low while still delivering live information.

Support and Community

• Issue tracker

• Discussion board

• Contributing guide

• Email support

• Instagram showcase

Need onboarding help or want to showcase your widget layout? Open a discussion thread and include screenshots or configuration snippets so others can learn from your setup.