[UNMAINTAINED] A dark theme for Facebook. Available as a Stylish user skin and a custom theme in Social Fixer for Facebook.
CSS JavaScript Makefile Other
Latest commit 6a58a46 Dec 12, 2016 @dtinth committed on GitHub mark as unmaintained
Permalink
Failed to load latest commit information.
chrome add google chrome extension Mar 18, 2015
docs
firefox
hooks Update hooks... Nov 24, 2013
lib
scripts [timeline/page-nav, timeline/unit] Update theme for new "single-colum… Apr 8, 2014
src [timeline/sidenav] fix the side navigation of the timeline Mar 18, 2015
test [events] Style the events page. Mar 29, 2014
vendor more tweaks Nov 23, 2013
.gitignore remove old previewer codes Mar 18, 2015
.tern-project initial commit Nov 21, 2013
.travis.yml add flowdock Sep 5, 2014
CONTRIBUTING.md update the contribution guideline Nov 28, 2013
Makefile alternate deployment option, to appspot Mar 29, 2014
README.md mark as unmaintained Dec 12, 2016
package.json
server.js
theme-info.txt [timeline/page-nav, timeline/unit] Update theme for new "single-colum… Apr 8, 2014

README.md

UNMAINTAINED (see #74)

dark-facebook 2 Build Status

dark-facebook is a dark theme for facebook that you can install in your browser.

Usage

See the website

Contributing

Because facebook is a big website, your contribution would help this theme become more complete.

Please check out:

Development

  1. First, install Node.js.
  2. Download the source code.
  3. And run npm install to install the dependencies.
  4. Start the development server: node server.js
  5. Download and install the extensions for your browser:
  6. Disable the dark theme in Stylish/Social Fixer.
  7. When you go to Facebook, you should see: "Develop dark-facebook" button at the bottom-right corner of the screen. Click that button.
  8. Facebook should become dark.

History

The Second Generation

The first version suffers several serious problems:

  • It overrides the colors of every elements (making all elements transparent, and start adding colors from there).
    • First, it triggered facebook's High Contrast mode.
    • Also, a lot of unthemed components are totally unreadable.
  • All code is in one file, making it easy to write at first, but soon it became extremely unmaintainable, and it's not contribution-friendly.
  • Facebook likes to change CSS classes easily.

The Next Approach

  • Separate the component styles from facebook's selectors. Since facebook likes to change CSS classes, we should not depend on them too much. Our approach is to give each and every component a name, then have a "selector definition" file that maps a selector to appropriate component.
  • Work in multiple files, making it easier to search for things.
  • Better documentation. The selector definition file should contain human-readable and descriptive information about each component: What does this component refer to on facebook, and where to find it.
  • Contribution friendly. I should invest more time in making this project as documentation-friendly as possible.
  • No Global Override. This time, we will add dark styles to facebook, component by component.