Scriptable iOS Widgets

Appearance

Birthday Life Progress Widget ​

ScriptableWidget SizeDisplayParameterThemeStatusLast Updated

A minimalist Scriptable widget that shows:

  • 🎂 Your age in years (accurate to 2 decimals)
  • 📅 Total days lived
  • 💫 Animated ring showing how far you are from your next birthday

A beautiful way to reflect on your life — at a glance.

✨ Features ​

  • 🧠 Calculates exact age from your birthdate (2 decimal precision)
  • 📆 Shows total days lived since birth
  • 🔄 Next birthday countdown (as a circular progress bar)
  • 📊 Progress ring updates dynamically each day
  • 🎨 Clean dark gradient background
  • 🔧 Customize with your name and birthdate via widget parameter

📥 Setup Instructions ​

1. Add the Script to Scriptable ​

  1. Install the Scriptable app
  2. Create a new script named BirthdayWidget
  3. Paste the full widget code into the editor
  4. Save the script

2. Add to Your Home Screen ​

  1. Long-press your Home Screen → tap +
  2. Search for Scriptable
  3. Choose Small Widget
  4. Tap Add Widget
  5. Long-press the widget → tap Edit Widget
  6. Set the Script to BirthdayWidget
  7. Set the Parameter as:
<name>, <birthdate>

Example:

rushi, May 11 2005

🧩 Widget Parameter Format ​

Parameter ExampleBehavior
rushi, May 11 2005Sets name to Rushi, birthdate to May 11 2005
janvi, apr 24 2011Sets name to Janvi, birthday ring updates accordingly

The widget capitalizes the first letter of the name and displays Name's Life.

📐 Layout Breakdown ​

ElementDescription
🟡 Progress RingVisual progress toward next birthday
📛 Name TextName’s Life
📅 Date InfoShows birthday (e.g., May 11 2005) and days lived
🔢 Age BlockShows age in years with line-wrapped "years old"

🎨 Theme ​

  • Uses a dark gradient background (#202020 → #000000)
  • Progress ring color: #FFD723 (golden yellow)
  • Text colors:
    • Name: #ccff00
    • Age: #b8bdfb
    • Subtext: gray

Feel free to modify these in the script for a more personal palette.

📸 Screenshots ​

🙌 Feedback ​

Got feature ideas or want a version with weekly/monthly views?
DM me on Instagram or email me at rushiofficial1205@gmail.com.

Widgets aren’t just tools — they’re reflections of your life. Let’s build something personal.

📜 License ​

This widget is open-source under the MIT License.
Feel free to fork, remix, and personalize — just give credit.

​

Enjoy tracking your journey ~ RP