Lazy-load seasonal theme CSS/keyframes only when a seasonal overlay is active #167
Closed
opened 2026-09-17 23:06:35 -04:00 by jared
·
1 comment
No Branch/Tag Specified
lotus
update-packages
sw-fix
read-me-update
image-path-changes
dm-calls
fix-2469
renovate/element-hq-element-call-embedded-0.x
renovate/npm-i18next-http-backend-vulnerability
renovate/npm-vite-vulnerability
dev
docs-update
more-theme
fix-257
imporve-thread-reply
revert-2402-improve-menu-congestion
mxidColor-toggle
update-sw-main-msg
v4.11.1
v4.10.5
v4.10.4
v4.10.3
v4.10.2
v4.10.1
v4.10.0
v4.9.1
v4.9.0
v4.8.1
v4.8.0
v4.7.1
v4.7.0
v4.6.0
v4.5.1
v4.5.0
v4.4.0
v4.3.2
v4.3.0
v4.2.3
v4.2.2
v4.2.1
v4.2.0
v4.1.0
v4.0.3
v4.0.0
v3.2.0
v3.1.0
v3.0.0
v2.2.6
v2.2.5
v2.2.4
v2.2.3
v2.2.2
v2.2.1
v2.2.0
v2.1.3
v2.1.2
v2.1.1
v2.1.0
v2.0.4
v2.0.3
v2.0.2
v2.0.1
v2.0.0
v1.8.2
v1.8.1
v1.8.0
v1.7.0
v1.6.1
v1.6.0
v1.5.1
v1.5.0
v1.4.0
v1.3.2
v1.3.1
v1.3.0
v1.2.1
v1.2.0
v1.1.0
v1.0.0
Labels
Clear labels
a11y
area: appearance
area: auth-session
area: build-ci
area: calls
area: desktop
area: media
area: messaging
area: mobile
area: moderation
area: navigation
area: notifications
area: settings
area: threads
bug
dependencies
docs
duplicate
enhancement
help wanted
invalid
needs-human-review
performance
planning
priority: critical
priority: high
priority: low
priority: medium
qa
question
research
security
tech-debt
ux
wontfix
Accessibility: keyboard, screen reader, contrast, motion
Client area: appearance
Client area: auth-session
Client area: build-ci
Client area: calls
Client area: desktop
Client area: media
Client area: messaging
Client area: mobile
Client area: moderation
Client area: navigation
Client area: notifications
Client area: settings
Client area: threads
Something is not working
Third-party package versions and advisories
README / LOTUS_* docs wrong or missing
This issue or pull request already exists
New feature
Need some help
Something is wrong
Re-render storms, leaks, heavy work on hot paths
Data loss, security hole, or crash on a main path
Broken feature or serious usability problem
Minor issue or polish
Wrong behaviour in an edge case or notable degradation
Manual QA: shipped, needs a human in a real environment
More information is needed
XSS, unsafe URLs, data leaks, auth/session
Code health, dead code, fragile patterns
Usability or visual inconsistency
This won't be fixed
Milestone
No items
No Milestone
Features 2026-Q4
Projects
Clear projects
No projects
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: LotusGuild/cinny#167
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Verify with the bundle analyser whether the 11 seasonal overlays (and their particle keyframes) are in the main CSS/JS for everyone year-round. If so, split each overlay into its own chunk (dynamic
import()whenseasonalThemeOverride/auto-date selects it), keep the auto-date decision logic in the main bundle. Same for the animated chat backgrounds if they are always bundled. Report the before/after incheck-bundle-sizeoutput.Verified and done for the overlays in
8658ec05: all 11 seasonal overlays (particles + their vanilla-extract keyframes) were in the main JS and the main CSS year-round. Each is now aReact.lazychunk (Halloween-*.js+Halloween-*.css, …) fetched only when that season is active (auto date or override) or previewed in Settings → Appearance; the schedule/override decision stays in the main bundle.check-bundle-sizebefore → after: largest chunk 332.4 → 320.1 kB gzip, main CSS 68.4 → 56.5 kB, total gzip 1551.6 → 1561.3 kB (per-chunk overhead, paid only when a season is on). Headless check: zero theme chunks requested at startup withautoout of season; opening the Settings grid fetches the 11 previews; picking Halloween renders the full-screen overlay.Animated chat backgrounds: the 18 background definitions are ~117 KB of source (inline data-URI SVG strings) behind a synchronous
getChatBg()used by RoomView, the call embed, the sidebar and the settings previews — splitting them needs an async hook at every call site for maybe 20–30 kB gzip. Leaving that as a possible follow-up rather than doing it here.