gnome-shell/data/theme
Florian Müllner ad3e9ab205 docs: Clarify where style changes should be done
After the move to Gitlab, the gnome-shell-sass repository is more
exposed than it used to; clarify that it is not the place where
style changes should happen, but rather the corresponding subtree
in the gnome-shell repository.
2018-05-23 19:03:01 +02:00
..
gnome-shell-sass docs: Clarify where style changes should be done 2018-05-23 19:03:01 +02:00
calendar-arrow-left.svg Calendar: Implement new mockup 2011-01-31 11:52:27 -05:00
calendar-arrow-right.svg Calendar: Implement new mockup 2011-01-31 11:52:27 -05:00
calendar-today.svg calendar: make day with events more prominent 2015-04-15 13:05:01 +02:00
checkbox-focused.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
checkbox-off-focused.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
checkbox-off.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
checkbox.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
close-window-active.svg add missing close button states 2017-09-22 17:13:07 +02:00
close-window-hover.svg add missing close button states 2017-09-22 17:13:07 +02:00
close-window.svg add missing close button states 2017-09-22 17:13:07 +02:00
close.svg
corner-ripple-ltr.png Fix ripple animation for RTL locales 2011-03-22 19:35:21 +01:00
corner-ripple-rtl.png Fix ripple animation for RTL locales 2011-03-22 19:35:21 +01:00
dash-placeholder.svg
filter-selected-ltr.svg theme: Adjust CSS for RTL locales 2011-03-05 19:49:21 +01:00
filter-selected-rtl.svg theme: Adjust CSS for RTL locales 2011-03-05 19:49:21 +01:00
gnome-shell-high-contrast.scss HighContrast: provide more contrasty switches 2015-04-15 19:35:51 +02:00
gnome-shell.scss theme: Use gnome-shell-sass as a submodule 2015-02-20 17:15:29 +01:00
key-enter.svg theme: Update OSK theme 2018-02-15 21:30:54 +01:00
key-hide.svg theme: Update OSK theme 2018-02-15 21:30:54 +01:00
key-layout.svg theme: Update OSK theme 2018-02-15 21:30:54 +01:00
key-shift-latched-uppercase.svg theme: Update OSK theme 2018-02-15 21:30:54 +01:00
key-shift-uppercase.svg theme: Update OSK theme 2018-02-15 21:30:54 +01:00
key-shift.svg theme: Update OSK theme 2018-02-15 21:30:54 +01:00
logged-in-indicator.svg loginDialog: Indicate whether users are logged in 2012-08-01 22:20:35 +02:00
meson.build build: Minor cleanups 2018-02-20 11:09:40 +01:00
message-indicator-symbolic.svg dateMenu: Use icon for message indicator 2017-09-12 17:32:51 +02:00
no-events.svg calendar: Add MessageList and Section/Message base types 2015-02-20 17:38:04 +01:00
no-notifications.svg calendar: Add NotificationSection to message list 2015-02-20 17:39:25 +01:00
noise-texture.png theme: Use the noise texture for the background of the screen shield 2012-08-03 14:00:48 -03:00
pad-osd.css ui: Add PadOsd 2016-11-04 16:08:10 +01:00
page-indicator-active.svg theme: Add hover/active states to indicators 2013-09-27 15:50:28 +02:00
page-indicator-checked.svg theme: Add hover/active states to indicators 2013-09-27 15:50:28 +02:00
page-indicator-hover.svg theme: Add hover/active states to indicators 2013-09-27 15:50:28 +02:00
page-indicator-inactive.svg theme: Add hover/active states to indicators 2013-09-27 15:50:28 +02:00
process-working.svg spinner: use a 60fps spinner 2015-08-05 13:44:32 +02:00
README.md docs: Use Markdown 2018-05-23 19:03:01 +02:00
running-indicator.svg theme: Make the running indicator look as it's supposed to 2011-06-27 12:53:38 -04:00
source-button-border.svg MessageTray: style summary sources 2011-03-21 21:50:27 -04:00
summary-counter.svg messageTray: Restyle the summary counters 2012-09-10 17:41:30 +02:00
toggle-off-hc.svg HighContrast: provide more contrasty switches 2015-04-15 19:35:51 +02:00
toggle-off-intl.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
toggle-off-us.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
toggle-on-hc.svg HighContrast: provide more contrasty switches 2015-04-15 19:35:51 +02:00
toggle-on-intl.svg theme: dark $selected_bg_color for toggle switches 2015-04-15 13:04:20 +02:00
toggle-on-us.svg theme: dark $selected_bg_color for toggle switches 2015-04-15 13:04:20 +02:00
ws-switch-arrow-down.png Use symbolic icons for workspace switch OSD 2012-08-13 13:27:40 -04:00
ws-switch-arrow-up.png Use symbolic icons for workspace switch OSD 2012-08-13 13:27:40 -04:00

Summary

Do not edit the CSS directly, edit the source SCSS files and the CSS files will be generated automatically when building with meson + ninja and left inside the build directory to be incorporated into the gresource XML (you'll need to have sassc installed).

How to tweak the theme

Adwaita is a complex theme, so to keep it maintainable it's written and processed in SASS, the generated CSS is then transformed into a gresource file during gtk build and used at runtime in a non-legible or editable form.

It is very likely your change will happen in the _common.scss file. That's where all the widget selectors are defined. Here's a rundown of the "supporting" stylesheets, that are unlikely to be the right place for a drive by stylesheet fix:

File Description
_colors.scss global color definitions. We keep the number of defined colors to a necessary minimum, most colors are derived from a handful of basics. It is an exact copy of the gtk+ counterpart. Light theme is used for the classic theme and dark is for GNOME3 shell default.
_drawing.scss drawing helper mixings/functions to allow easier definition of widget drawing under specific context. This is why Adwaita isn't 15000 LOC.
_common.scss actual definitions of style for each widget. This is where you are likely to add/remove your changes.

You can read about SASS on its web page. Once you make your changes to the _common.scss file, you can run ninja to generate the final CSS files.