⏳ Modular Time Progress

Visualize your day, week, month, year, and more — all in one modular and minimalist design Scriptable widget.

✨ Features

📆 Time-Based Visualizations Track progress for:
- Current day (with circular ring)
- Current week (ring or dot grid view)
- Current month (dot grid layout)
- Current year (animated ring)
- Week number (dot and ring styles)
🎨 Dark Theme with Gradients Clean black-to-gray gradients that make the visual elements pop.
🪄 Smooth Progress Rings Each progress type has its own elegant animation — circles, bars, and dots.
🧠 Intelligent Defaults No parameter? Widget shows Today, This Week, This Month, and This Year bars in a clean stack.

Setup

Download the ModularTimeProgress.js script into your Scriptable app.
Long-press your iOS home screen, tap +, and add a Scriptable widget.
Edit the widget and choose:
- Script: ModularTimeProgress
- Parameter: Any of the valid options (see below)

For visual variety, try stacking different widget sizes and parameters.

📸 Screenshots

Day Progress (`day`)

Displays progress through the current day as a circular progress ring.

Month Progress (`month`)

Dot grid showing how far you are into the current month.

Year Progress (`year`)

Circular ring showing yearly progress with days passed.

Week Progress (`week`)

Displays how far you are through the current week.

Week Number Dot View (`weeknum`)

Circular ring showing yearly progress with weeks passed.

Week Number Dot View (`weeknumdot`)

Dot grid marking each week of the year.

Default Mode (`default`)

Stacked bars showing:

Today
This Week
This Month
This Year

Configure Parameters

Parameter	Widget View
`day`	Circular day progress widget
`month`	Monthly dot grid with current day
`year`	Yearly progress ring (0–100%)
`week`	Weekly ring progress
`weeknumdot`	52-week grid, active/inactive dots
`default` (or empty)	Stacked progress bars: day, week, month, year

Parameters are case-insensitive. Use lowercase for best results.

🙌 Feedback

Have questions or want help customizing it? DM me on Instagram or email me at rushiofficial1205@gmail.com.

Widgets shouldn’t be limited to timers—I’d love to build tools that help you passively learn, reflect, or stay organized. If you have a unique concept in mind, I’d love to collaborate.

📜 License

This project is licensed under the MIT License.

Feel free to fork, build upon, and remix with attribution.

Enjoy using this widget ~ RP