nextcloud-server/apps/theming
Ferdinand Thiessen 91f3b6b4ee
chore: adjust code to new codestyle
Signed-off-by: Ferdinand Thiessen <opensource@fthiessen.de>
2025-10-02 13:19:42 +07:00
..
appinfo chore: Bump app versions and requirements 2025-09-04 09:11:05 +07:00
composer fix: Use migration instead of repair step for restoring custom color 2024-09-10 17:51:27 +07:00
css fix(ui): Update assistant text gradient 2025-09-25 12:00:57 +07:00
fonts fix(a11y): Update OpenDyslexic from 0.920 to 2.001 2024-09-12 16:53:13 +07:00
img fix(theming): previews need the same file extension as their originals 2025-08-21 19:22:45 +07:00
js chore: Add SPDX header 2024-05-31 10:38:47 +07:00
l10n fix(l10n): Update translations from Transifex 2025-09-30 00:13:38 +07:00
lib fix(ui): Update assistant text gradient 2025-09-25 12:00:57 +07:00
src chore: adjust code to new codestyle 2025-10-02 13:19:42 +07:00
templates chore: Add SPDX header 2024-05-31 10:38:47 +07:00
tests fix(tests): Fix PHPUnit deprecation warnings in tests 2025-09-27 13:05:32 +07:00
.l10nignore chore: Add SPDX header 2024-05-31 10:38:47 +07:00
README.md feat(theming): add new default background for Nextcloud 32 2025-08-21 19:22:45 +07:00
REUSE.toml fix(theming): previews need the same file extension as their originals 2025-08-21 19:22:45 +07:00
openapi.json chore(deps): Update nextcloud/openapi-extractor to v1.8.3 2025-09-01 16:04:54 +07:00
openapi.json.license chore: Add SPDX header 2024-05-31 10:38:47 +07:00

README.md

Theming

Background picture requirements

A reference to why it was very difficult to actually find good background pictures there are quite some requirements when it comes to picking:

  • It needs to be an exceptionally good photo of course since when chosen, people will see it every day.
  • We need to have a good balance of different motives, e.g. not too many landscape pics.
  • Same for a good balance of different colors.
  • The photo needs to work as a background. Photos with objects focused in the middle dont really work as they will be overlapped by the widgets and content anyway.
  • Especially the top part cannot have too much differing contrast, as then its not possible to see the navigation icons.
  • Especially the top part should be either dark-ish or light-ish, but not a shade exactly inbetween because then contrast can neither be achieved with light nor dark icons.
  • We serve the pictures at 4k resolution and most of the selected images are also available in 6k or higher so it is future-proof.
  • For the search of course we had to limit to CC0, CC By and CC By-Sa. Only CC0 would have been practically impossible cause theres just not so many good ones which fit.
  • Good pages to find photos are StockSnap, Wikimedia Commons, Openverse and Flickr (with license "commercial use & mods allowed"), sorting by interesting or downloads. Most others like Unsplash, Pexels, Pixabay, etc. meanwhile have a non-standard license.

Background picture technicals

  • All backgrounds are sized to maximum 3840px width (4K resolution).
  • To ensure quick loading times, the image needs to be compressed, ideally to around 1 MB or less. E.g. via 9095% quality in GIMP export. We could also explore using newer formats.
  • Previews are sized to 352px width (min height 192px), which is double of the current picker grid size so it looks nice on high-res displays. Quality is also set to around 90% at export.
  • Newer background images are compressed using WebP and a quality of 90 (cwebp -q 90 -o ... ...)

Background picture credits

In img/background/: