anton-kasperovich / jenkins-material-theme

Beautify your Jenkins with the Material Design theme!

jenkins-material-theme

Beautify your Jenkins with the Material Design theme!

Website: http://jenkins-contrib-themes.github.io/jenkins-material-theme

So you love Jenkins but hate its ugly user interface and icons... Me too! Introducing Jenkins Material Theme. You can turn your favorite frog CI tool into a handsome prince in few steps!

Features

• Just one small css file (35K)
• Embed minified SVG images
• Multiple ways to install
• Customize the color and logo using the generator

Screenshots

Installation

Using this GitHub page (recommended) (auto-updated)

1. Choose your color:

2. Replace {{your-color-name}} in the URL by the chosen color: https://jenkins-contrib-themes.github.io/jenkins-material-theme/dist/material-{{your-color-name}}.css

3. Install Jenkins Simple Theme Plugin

4. Click Manage Jenkins

5. Click Configure System and scroll down to Theme

6. Set the CSS field to the generated URL.

7. Click Save

Using your Jenkins Hosting

1. Follow the step 1 and 2 of the previous method

2. Download the generated URL

3. Upload the downloaded file to your web server

4. Follow the steps 3 to 7 of the previous method using your uploaded file as URL in step 6

Using Stylish (only you will be able to see the awesome theme)

1. Follow the step 1 and 2 of the previous method

2. Copy the content of the file downloaded file

3. Install the Stylish Chrome extension

4. Go to Stylish options and click in Write new style

5. Paste the theme css in the code box

6. Click in Specify and set your jenkins domain

7. Click in Save

8. Go to your Jenkins website and enable the theme in the Stylish Chrome toolbar icon

Development

CSS file are minified and compressed with Grunt. To prepare the environment:

npm install
grunt

This will generate the following file:

• dist/material-light.css

Compatibility

• Simple Theme plugin 0.3
• Jenkins 1.636
• Firefox 3.5+
• Chrome 4+
• Safari 4+
• Opera 15+
• Microsoft IE11 and Edge

If you are experiencing issues please let me know! Also, feel free to contribute!

License

http://afonsof.mit-license.org/

##Thanks to

• Simple Theme Plugin for the Simple Theme plugin
• Google for the the material design inspiration and the icons
• Material Design Icons for some extra icons
• Stylish for making the test of new versions easy
• canon-jenkins for the base theme
• @Heldroe for Firefox and Microsoft support
• @bootstraponline for Jenkins native plugin