Custom CSS for websites to make the internet beautiful. Transparency being the main feature, these themes also include removal of distractions and further useful features for each website.
-
You can use the example.com.css as a starter for most websites to grab the stylesheet format.
-
Make sure the file is named in the correct format [website domain].css (google.com.css and docs.google.com.css are 2 styles which are not merged unless you do 9.)
-
Please respect auto theming for day and night themes. If the website does not have a dark theme, account for dark reader.
-
Do not use wildcards such as applying transparency for all div elements since that is handled with force theming in the addon.
-
Every property should include
!important
to make sure it gets applied. -
Do NOT leave commented out code.
-
Don't include
www
in the stylesheet file name. -
Add propper comments for each section of a feature at the beginning with a clear but compact description.
-
For theming similar domains like app.arduino.cc , login.arduino.cc ..... similar urls with
prefixes
, you can add a general style with a leading+
symbol when creating the stylesheet. (+arduino.cc.css
) example -
Similarly, for theming websites with a shared domain but with different
suffixes
(like google.com, google.lk...), you can add the-
symbol to the start of the stylesheet file name so it will replace the provided domain of the file name's domain. (-google.com.css
). example -
[optional] Each comment of the same file should have a unique domain specific identified prefix (yt- ytm- gh- ...) which will help the browser to separately apply themes.
/* yt-transparency */ :root{ --colorBgApp: transparent !important; } /* yt-no footer */ footer.app-footer { display: none !important; }
-
Always make sure the first feature is
transparency
and also use the exact feature name without a difference allowing the global transparency toggle to work. Prefixes with-
are acceptable. -
Don't keep the firefox selectors if you are coying over from the userContent.css (remove
@-moz-document domain(" ")
) -
Once comitted to the repository, github actions will parse the css file and update/ generate the styles.js and then will be deployed to the github pages allowing the add-on to fetch from it.