Skip to content

galette/theme-redmine

Repository files navigation

PurpleMine 2

A free Redmine 3.0+ theme written in SCSS.

The MIT License JavaScript Style Guide Run linters Issues


Screenshot

It's written in SCSS. It uses normalize.css and benefits from some parts of Bootstrap like mixins, structure, and stuff.

Main features

  • Bigger, easier to read fonts,
  • Github-like wiki content look,
  • Sidebar moved to the left for better ergonomy,
  • Coloring trackers links (on lists, issue pages and even in the wiki content),
  • Jira-inspired priority icons,
  • Toggling sidebar visibility,
  • Easy to customize via variables.

How install it

To install PurpleMine, just download .zip and unpack it to your Redmine's public/themes folder.

Then go to Redmine > Administration > Settings > Display and select PurpleMine2 from the list and save the changes.

Plugins

This theme also features a new look for Redmine Backlogs plugin. To install it, simply copy stylesheets from PurpleMine2/plugins/redmine_backlogs and overwrite files in {redmine}/plugins/redmine_backlogs/assets/stylesheets and restart Redmine.

Also, Redmine Time Tracker and Redmine People plugins should look nice with PurpleMine.

How to customize it

If you want to customize PurpleMine to your needs, first, make sure that you have installed node.js and npm is available in your terminal.

Then, from the directory that contains PurpleMine run:

npm install

Now all the dependencies should be ready to use. Run one more command:

npm run watch

And now the grunt is watching for changes in files placed in src/ folder. Just change what you need, and it'll run Sass preprocessor automatically.

Regrettably, optional file include is not possible in Sass, so I would recommend creating a new file, e.g. src/sass/_custom-variables.scss and importing it a the beginning of the application.scss file. That way all the variables with the !default flag could be overridden.

The path src/sass/_custom-variables.scss is added to .gitignore so it should make upgrading PurpleMine with keeping your changes rather painless, given that the only thing you changed in PurpleMine's source was adding this one line with @import "custom-variables";.

If you need to customize styles for Redmine Backlogs remember to include your _custom-variables.scss in src/sass/plugins/redmine_backlogs/_common.scss.

Changelog

Changelog.