Bootstrap 3.1.0 released

New docs

We’ve made tons of changes across the board, most notably to our documentation. Just like v2.1 brought a brand new design, v3.1 overhauls the docs to refocus on the actual documentation rather than the chrome around it. Our new homepage restores the quick run through of key features and showcases some awesome examples from the Expo.

Official Sass port

The best part about v3.1 is that we’re shipping with an official Sass port. A few weeks ago we moved over the most popular port on GitHub and made it official—Bootstrap is now available in Sass. Rather than bloat the main project with support for Less and Sass—and all the documentation for both—we’ve kept them separate for the time being. Prominent links in the docs are included though, so enjoy!

New examples

We’ve added three new examples: Blog, Cover, and Dashboard. Each example provides a single page of awesomeness for you to quickly get started on a project built with Bootstrap. They’re responsive and ready to go.

Improved features

A handful of features that aren’t exactly new to Bootstrap have seen an update in v3.1:

Modals now include optional sizes

Dropdowns now have their own alignment classes for easier customization

Form feedback styles for validation states now include optional icons to reinforce color changes

All-in-all these make components more focused, more durable, and easier to work with. See the changelog included with the GitHub release for the complete list of new features.

Remote modal content

One of the more important improved features is for our modals. If you currently use the modal’s remote option, be aware this release may break your modals. Yes, this is a breaking change, but it’s first and foremost a bug fix that corrects a rather longstanding and overlooked error. Our apologies for any headaches it may cause, but it’s been missed in the last few patch releases.

New license

We’ve been talking about it for what seems like forever, but thanks to all our contributors and the core team, we’ve finally done it. As of v3.1, Bootstrap ships under the MIT license to allow as many people to utilize Bootstrap as possible. Thanks to all our contributors for helping make it happen.

Improved build tools

We’re constantly trying to improve our tools for developing Bootstrap and v3.1 brings a slew of updates to do just that.

We’ve switched from Recess to grunt-contrib-less for our compiler, giving us access to Less 1.6.x (as opposed to 1.3.x with Recess).

Our compiled code is virtually identical in formatting and organization thanks to CSScomb and some other Grunt-fu.

Tests also run a tad faster with the help of some magical caching and parallelization.

The web Customizer is now generated from a Grunt task, meaning we’ll never miss updating or adding a variable again. If you contribute to Bootstrap regularly, just run grunt and commit to update the page.

Heads up! If you develop Bootstrap locally, be sure to nuke your node_modules/ directory and run npm install before getting started with v3.1.

Download Bootstrap

Get downloading now, or see the list below for more information on what’s new in this release. Download it from GitHub or snag it from the CDN:

#11836: Add new form control feedback classes to toggle icons for each validation state. Works on regular forms, horizontal, and inline.

While we originally wanted v3.1 to include RTL support, we decided to hold back on that for some potentially beneficial unreleased tooling. We’ll share more on that when we know more, but suffice to say it’s been bumped to v3.2.

CSS changes

#10951: Add outline: 0 to .modal to prevent a focus outline from appearing in Chrome for Windows.

Deprecations

#10370: Deprecated the .pull-right method for aligning dropdown menus. Includes the following changes:

Removed an old and unused pair of selectors that didn’t properly target the right-aligned navbar alignment of dropdown menus.

Deprecates the .pull-right alignment in favor of a more specific and unique class name.

Adds .dropdown-menu-right as the new alignment class. This is then mixin-ed into the .navbar-right.navbar-nav dropdown menus for auto-alignment (keeping the current behavior we have today).

Adds new ability to override that auto-alignment though with the new .dropdown-menu-left, which is mixin-ed in the same way to provide the appropriate specificity of an override. This should never need to be used except for within right-aligned .navbar-nav components.

#11660: Deprecate small and .small in blockquote citation in favor of footer element.