[Contributions Welcome] Widget unreadable on iOS 26 with Liquid Glass "Clear" Homescreen

[kaiser-jan]

As discovered in #10, when using the "Clear" Theme on the Homescreen on iOS 26, every item with a background turns to an intransparent white, causing text to be indistinguishable from the background.

Adding support would probably be possible by adapting/removing the background colors.
This might be verifiable by changing the colors of displayed Subjects in Settings > Subjects (I don‘t have a device on iOS 26 myself).

If someone would like to help, I am open to contributions on this issue. Please comment here if you start working on this.
Here are some ideas on the implementation:

• experiment with what changes are necessary (slightly opaque background? no background at all?)
• add a toggle for clear mode in the settings (as we most probably won’t be able to detect when clear mode is selected)
• override the background colors when the clear mode setting is active (in views/
• find alternate methods to visualize states which colors represented until now (e.g. cancelled lessons)

[LeviiiCraft2]

Hi,
As you know I came across this issue myself in #10, and since I was the one who discovered the issue, I made it my task to fix it.

What I changed:

• Added a new toggle in Settings → Appearance called “🪟 Liquid Glass Mode” (default: off).
• When enabled, all widget backgrounds and text colors are overridden with slightly transparent colors and dynamic text (black in light mode, white in dark mode).
• This affects not only Subjects but also Exams, Grades, Absences, and so on, so everything stays readable on iOS 26 Clear Homescreens.
• Canceled/Free lessons still keep their distinctive styling, but remain readable.

Result:
With Liquid Glass Mode ON, the widget no longer turns into unreadable white blocks. With it OFF, the old style remains unchanged.

UntisWidget.js
⚠️ I’m not completely sure if this introduced any other side effects or bugs, but in my testing it works well so far.

Best regards,
LeviiiCraft

[kaiser-jan]

Oh, that sounds great! Could you maybe open a PR with your changes? Then I could review the changes and release it, so everyone can benefit from your work :)

[LeviiiCraft2]

Sure, I can do that. I just need to find out how lmao

[LeviiiCraft2]

Hi, so since I had some time, I made some other improvements too. I added interactive homeworks (you can tick them off) as well as some other things. If I am finished with Everything I will try doing the PR. Would you like only the Liquid Glass Mode or it combined with the other improvements?

[kaiser-jan]

Oh, that sounds really cool!
If it's not too much work, I would prefer separate PRs for fixing Liquid Glass and for the new improvements/features. But as long as the changes are separated into logical commits, reviewing all changes in one PR should work as well.

[LeviiiCraft2]

Hi,
I just wanted to mention that this is actually my first time working with TypeScript, so I’m not 100% sure if I placed everything exactly where it should be or if some parts could be cleaner.
I tried to keep the structure consistent with the existing code and made sure everything still runs fine inside Scriptable — but please double-check the TS parts during review just to be safe.

To make testing easier, I’ve also attached my fully working Scriptable files below (the version I’ve been using for development and testing).
That way you can directly see how the widgets behave with all the new features integrated:
#12: UntisWidget-liquid-glass-implementation.js
#13: UntisWidget-homeworks-and-ui-improvements.js

Thanks again for maintaining this awesome project — really enjoyed extending it!