This week we’ve release PatternFly 2.0. This guide will go step by step on how to upgrade from PatternFly 1.x to our latest version.
PatternFly 2 is (almost) backwards compatible with v1.x
There are three major changes that you should know about:
- We don’t support Internet Explorer 8 anymore.
- We’ve split the CSS into two files (
patternfly-additions.*css) to avoid a limitation of Internet Explorer 9 where only 4095 selectors are recognized in a single stylesheet.
- and we’ve moved
First: Get PatternFly 2.0
The first step is to upgrade the PatternFly codebase. This process will be different depending on how your project manages its depencies.
Upgrade using Bower:
Upgrade using Npm:
Upgrade using Git:
Add PatternFly as a remote repo, fetch it and rebase
Get the ZIP:
Or just Downloading the zip file from github
Changes on the HTML
Since we no longer support IE8, you can remove IE8 utilities (html5shiv and respond) from all your pages.
Link two CSS instead of one
We’ve split PatternFly styles into two style sheets. The links to the styles will look something like this:
We’ve upgraded most of our dependencies. You can see the complete list on the release. If you need a version other than what is checked into patternfly/components, you’ll have to pull it yourself.
Changes on LESS
If you are extending PatternFly styles using less, import patternfly-additions.less as a base to your styles, and compile again. Remember to load both
patternfly*.css and your styles on the HTML.
For more information on upgrading to v2.0, send an email to the Patternfly Mailing List or join the IRC channel #patternfly on Freenode.