CONTRIBUTING.md

Contriburing to Darkness

Please help us improve existing skins and create new ones. Pull requests are welcome!

How to start developing?

1. If you haven't yet, first install Darkness locally
2. Run npm start to watch SCSS files and compile them in real-time.
3. Write your awesome code - see below

How do I...

Fix or improve an existing skin

Edit /themes/websites/[WEBSITE].scss (e.g. /themes/websites/youtube.scss)

Add skin for an new website (e.g. GitHub, Twitter)

Open /themes/websites/WEBSITE-TEMPLATE.scss in your code editor and follow the instructions.

Fix or improve a color theme

Edit /themes/themes/[THEME].scss (e.g. /themes/themes/material.scss)

Create a new color theme (in addition to Monokai, Tomorrow, etc.)

Open /themes/themes/THEME-TEMPLATE.scss in your code editor and follow the instructions.

How to push code back to Darkness?

1. Please test your changes locally in Chrome
2. Commit and push:

   cd darkness
   git add .
   git commit -m "Description of Changes"
   git push origin master

3. Go to GitHub and navigate to your fork of Darkness.
4. Click the New pull request button (above the file list)
5. Click the Create pull request button.
6. Add a description for your pull request and click Create pull request

Advanced usage

• To compile all SASS files now: gulp sass:compile
• To watch all SASS files and compile in real-time: gulp sass:watch (alias: npm start)
• To clean up all .css and .css.map files: gulp sass:cleanup