bombadillo / 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
• Use your own Company logo with the generator

Screenshots

Installation

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

1. Install Jenkins Simple Theme Plugin

2. Click Manage Jenkins

3. Click Configure System and scroll down to Theme

4. Specify the URL for https://jenkins-contrib-themes.github.io/jenkins-material-theme/dist/material-light.css.

5. Click Save

Using the Native Jenkins Plugin

1. Download the file https://github.com/jenkins-contrib-themes/jenkins-material-theme/raw/master/hpi/material-theme.hpi

2. Go to Manage Jenkins > Plugins > Advanced

3. Select the downloaded file in the area Upload Plugin

4. Click Upload

5. Restart your Jenkins Server

Using your Jenkins Hosting

1. Upload the file https://jenkins-contrib-themes.github.io/jenkins-material-theme/dist/material-light.css to your web server

2. Follow the steps of the previous method using your uploaded file as URL in step 4

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

1. Install the Stylish Chrome extension

2. Copy the content of the file https://jenkins-contrib-themes.github.io/jenkins-material-theme/dist/material-light.css

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

4. Paste the theme css in the code box

5. Click in Specify and set your jenkins domain

6. Click in Save

7. Go to your Jenkins website and enable the theme in the Stylish Chrome t oolbar 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