Côme Chilliet c99ebaa866 fix(theming): Fix erronous phpdoc typing 6 months ago
..
appinfo 03090bb5ee feat(branchoff): Bump versions and requirements in apps 8 months ago
composer acda6b841e chore: Remove old theming migration steps as they are only needed once 9 months ago
css 4b8868a7f1 feat(theming): Provide CSS variable for favorite color and adjust for dark mode 8 months ago
fonts 4ce0990239 Update opendyslexia 2 years ago
img 09b34fb437 fix(theming): Add adjusted color versions of default background for better app-menu contrast 11 months ago
js 9ec32a739c Purge unused legacy code and drop 3rdparty jscolor dependency 2 years ago
l10n 6e94aba264 Fix(l10n): Update translations from Transifex 7 months ago
lib c99ebaa866 fix(theming): Fix erronous phpdoc typing 6 months ago
src b758e0496e fix: Correctly import types in Typescript files 9 months ago
templates 4a2bbc7af9 Rewrite admin theming in Vue 2 years ago
tests ec5133b739 fix: Apply new coding standard to all files 7 months ago
.l10nignore f6c729a96c Update .l10nignore for apps to exclude bundled JS files 4 years ago
README.md 8c9a9195b9 Add distraction free backgrounds for Nextcloud 26 1 year ago
openapi.json f8ab422d81 chore(deps): Update openapi-extractor 7 months ago

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 don’t 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 it’s 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 there’s 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 90–95% 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.

Background picture credits

In img/background/: