Opale Redmine Theme

A Redmine 6.x theme.

---

Main features

• Left sidebar,
• Colored trackers links,
• Jira-inspired priority icons,
• Customizable with SCSS.

Releases

• Redmine 6.x : use either the latest stable release (1.6.5), or use the redmine-6.x branch of this repository.
• Redmine 5.x : use either the latest stable release (1.5.3), or use the redmine-5.x branch of this repository.

Install

To install this theme :

1. download the lastest stable release and decompress the archive to your Redmine's themes folder,
2. rename the folder opale-1.6.5 to opale,
3. go to Redmine > Administration > Settings > Display, select Opale from the theme's list and save the settings.

Customize

If you wish to customize this theme to your needs, it is recommended that you use Custom Opale Redmine Theme Builder.

You will be able to override the Sass variables defined in src/sass/_variables.scss with the !default flag, add a logo and/or a favicon, and eventually add any custom Sass style rules you want.

Troubleshooting

With Redmine 6.x, upon initial installation, depending on your server setup, it might occur that the theme appears to be broken because the assets were not loaded

This happens because the assets of the theme have not been precompiled properly by Redmine.

Usually simply restarting the server should fix that.

If not, run the command bundle exec rake assets:precompile RAILS_ENV=production.

If deploying to a sub-uri, set the relative URL root as follows: bundle exec rake assets:precompile RAILS_ENV=production RAILS_RELATIVE_URL_ROOT=/sub-uri.

If you still experience issues with missing assets in the browser, try removing the public/assets directory before re-running the precompile: ̀bundle exec rake assets:clobber RAILS_ENV=production.

About Redmine Backlogs plugin

This theme also features a new look for Redmine Backlogs plugin.

To install it, simply copy stylesheets from opale/plugins/redmine_backlogs and overwrite files in {redmine}/plugins/redmine_backlogs/assets/stylesheets.

Then restart Redmine.

Contributing

Bug reports and Pull requests are welcome. Please read more about contributing.

Authors

Read more about the authors.

Copying

Opale Redmine Theme is licensed under the GNU Affero General Public License v3.0 or later, the text of which can be found in LICENSE.

Licensing of included components:

• Normalize.css : MIT License,
• Bootstrap Mixins : MIT License,
• Tabler Icons: MIT License.

All unmodified files from these projects retain their original copyright and license notices: see the relevant individual source files in src/sass/vendor/