CSS
Clone or download

README.md

The Gtk+ Stylesheet for elementary OS

Bountysource

An original Gtk.CSS stylesheet designed specifically for elementary OS and its desktop environment: Pantheon.

This stylesheet is licensed openly under the terms of the GNU General Public License. Redistributing, forking, remixing, etc. are encouraged!

If you feel the desire to compensate the designers who maintain this stylesheet for your usage, please see this page and thank you!

Not a General Purpose Stylesheet

Special fixes for GNOME apps (Nautilus, GNOME Control Center, GNOME Shell, etc) or other desktop environments will not be implemented. The aim of style classes should be to be generic across applications. If an application needs a unique style, it should be bundled with that application.

Testing

This stylesheet doesn't need to be compiled. It is recommended to make a symbolic link from the source directory to "/usr/share/themes" for testing:

ln -s /path/to/your/branch /usr/share/themes/

Apps will need to be restarted or the system stylesheet will need to be changed for your changes to take effect.

You can also test changes live with Gtk Inspector. Make sure you have Gtk development libraries installed, then enable the inspector shortcut:

apt install libgtk-3-dev
gsettings set org.gtk.Settings.Debug enable-inspector-keybinding true

Open an app you wish to test your changes on. Open Gtk Inspector with the keyboard shortcut Shift + Ctrl + D, then navigate to the tab "Custom CSS". Your changes here will take immediate effect on the focused app.

We use stylelint for CSS linting. For testing locally:

  • You will need npm installed.
  • Run npm install to grab stylelint. You will only need to do this once.
  • Run npm test and it will lint all the CSS files.