v3.0.2

An impromptu patch release to fix the version numbers in our JavaScript files, restore some missing grid classes, and general improvements to our documentation.

• #10039: Remove window.jQuery for jQuery.
• #11273: Add branch alias for composer.json.
• #11295: Restore offset, push, and pull zero classes (e.g., 1.col-md-offset-0`)
• #11315: Add navigation role to example navbars.
• #11327: Improve nesting of .thumbnail styles.
• #11334: Remove unnecessary & from CSS nesting for panels.
• #11335: Add Grunt task to update version numbers across entire project. (Note: If you run our docs locally, you'll need to run npm install in order to run grunt).
• #11336: Don't use nonstandard window.location.origin in Customizer.
• #11345: Remove duplicate class changes in migration instructions.
• #11349: Add screen reader text for navbar toggles.
• #11378: Use .navbar-* alignment classes in .navbar-text example.
• Update Node to v0.10.x (current stable)
• Fix links to same-page anchors
• Drop media type on basic template example
• Correct download links in readme

For a full list of issues and pull requests in this release, see the v3.0.2 milestone.

v3.0.1

First patch release for v3, featuring dozens of documentation improvements, bug fixes, and small improvements.

Docs

• #9880: Use medium grid classes on jumbotron example
• #9887: Document .show and .hide classes
• #9908: Add type="submit" to Customizer compile button to prevent accidental submissions
• #9915: Fix inaccurate comment in media query docs
• #9917: Updated broken download link in README
• #9924: Removed non-ASCII character from non-responsive example CSS
• #9928, #9932: Update carousel example to work in IE10 and correctly display navbar in narrow viewports
• #9931: Add ARIA role="toolbar" to elements with .btn-toolbar in docs examples
• #9991: Better docs for tabbable tab markup and it's fade option
• #10011: Update Grunt instruction links and wording
• #10012: Add David to project readme to monitor dependency currentness
• #10034: Use npm-registered recent version of grunt-html-validation instead of its git repo
• #10040: Better cross referencing of default and navbar pull utilities
• #10042: Updated JS Fiddle tooltip delegation example linked in docs
• #10045: Use v2.3.2 release ZIP instead of master zip for downloads from old docs
• #10081: Documents workaround for tooltips+popovers on disabled elements
• #10082: Documents .navbar-form
• #10087: Add version number to all docs pages (in the footer)
• #10088: Updates accessibility docs regarding nesting heading elements
• #10112: More role attributes in the docs, this time on link buttons
• #10131: Corrects button group selector in JavaScript docs
• #10136: Broken image link in Carousel example
• #10146: Document data-ride carousel feature
• #10209: Fixed broken dismissable alert example
• #10215: More compressed touch icons, updates Respond.js to v1.3.0 and html5shiv.js to v3.6.2, adds bugs to package.json
• #10249: Correct component name of jumbotron component in Jumbotron example
• #10272: Removed unused link for nav alignment in Components page
• #10277: Mention removal of navbar vertical dividers in migration docs
• #10278: Change Google Maps compatibility warning to a general box-sizing warning with optional reset
• #10282: Cross reference tabs and tabs plugin
• #10298: Add progress bar to migration docs
• #10299, #10323: Getting Started wording changes
• #10316: Document .active and :active for buttons
• #10324, 10338: Restore opt-in warning for tooltips and popovers
• #10342: Update affix docs to better communicate plugin behavior
• #10344: Update IE8-9 support section with table of specific CSS3 and HTML5 features and their support in Bootstrap
• #10372: Homepage now shows two download buttons, one for our assets (CSS, JS, and fonts) and one for the source code (the entire repo)
• #10382: Update Disabling responsiveness docs section for brevity
• #10411: Color coded IE8-9 browser support table
• #10414: Carousel now uses Glyphicons as default left/right chevron icons (text icons are still supported)
• #10417: Document .hidden in the Helper classes Screen reader content section
• #10419: Add nav lists to migration guide
• #10453: Add additional screen reader text to button group dropdown toggles
• #10459: Update Customization section in Getting started page
• #10492: Account for responsive tables in panels
• #10497, #10584: Fix Windows 8 and Windows Phone 8 behavior in Internet Explorer 10 and applies "bug fix" to docs
• #10528: Add new About page to the docs with backstory, core team, community links, and translations
• #10573: Un-hardcode tooltip arrow widths and padding for easier customization
• #10591: Add modal remote option semantics change to migration docs
• #10693; Include a copy of the docs license as a file in the repo
• #10711: Address 100% fluid layouts in grid docs and the required padding
• #10768: Fix mention of renamed .img-polaroid class in Migration docs
• #10770: Rename /assets to /docs-assets to reduce confusion between /dist and docs dependencies
• #10790: Disable IE compatibility mode in all docs pages and examples
• #10856: Update grid docs to better explain the sizing and interactions when using multiple grid tier classes
• #11013: Use CDNs for jQuery and HTML5 shiv
• 3318a98: Add blog link back to docs homepage
• 8df05b9: Remove links to navbar examples from example navbars in Theme example
• 022e404: Delete smaller touch icons and only include one
• 5d1707a: Remove unused mention of .prettyprint styles from code.less (we no longer use that plugin and the class is undocumented, so we're nuking it)
• 6e06489: Remove unnecessary left and right properties from .modal-dialog since we use margin to center the modal
• 19db69c: Add Linux Firefox to supported browsers list
• 99b3515: update outdated JSFiddle example

Bug fixes and changes

• #9855: Partial fix for open modal content shifting: removed all margin settings to prevent some of the content shifting. Still needs JS love to detect scrollbars and adjust content accordingly (will address in v3.0.2).
• #9877: Add improved .active state to navbar nav in theme
• #9879: Add hover state (move gradient up 15px) to theme buttons]
• #9909: Add @component-active-color variable to complement @component-active-bg (and apply it to dropdowns, nav pills, and list group items)
• #9964: Add fonts directory to bower.json main files list
• #9968: Simplify striped progress bar mixin to remove unused color
• #9969: Add support for output element by styling it more like our .form-control
• #9973: Removed unnecessary -ms-linear-gradient prefix
• #9981: Account for hover and focus states on pagination disabled items
• #9989: Set monospace font-family on <kbd> and <samp> to match browser defaults
• #9999: Make .table-hover styling apply to <th> within contextual table rows too
• #10013: Position carousel left and right controls from the left and right, respectively
• #10014, #10406: Update grid to use width on .containers instead of max-width as IE8 doesn't fully support box-sizing: border-box when combined with min/max width/height
• #10022: Add width: 1em; to all empty Glyphicons to prevent loading flicker
• #10024: Use negative margin to fix the border between button and input in input groups
• #10025: Add additional transform mixins
• #10057: Autohiding scrollbars in responsive tables for Windows Phone 8
• #10059: Add .transition-property() mixin
• #10079: Native-style scrolling in responsive tables for iOS
• #10101, #10541, #10565: Generate CSS file banners via Gruntfile
• #10111: Use different colors for dropdown link hover and active states
• #10115: Default carousel controls and Glyphicon controls should behave the same on small devices and up
• #10126: Update responsive test cases to properly highlight hidden class examples
• #10153: Restore @headings-color variable
• #10154: Add .small to pair with our heading classes (e.g., h1 and .h1)
• #10164: Document .center-block() mixin and update CSS to include it as a class
• #10169: Remove old @navbar-inverse-search-* variables
• #10223: Add @input-color to .input-group-addon to match the form controls
• #10227: Use correct max-width on Offcanvas example media query and add overflow-x: hidden to prevent scrollbar on narrow devices
• #10232: Scope .table styles to immediate thead, tbody, and tfoot elements
• #10245: Add @breadcrumb-separator variable for customizing breadcrumbs
• #10246: Use correct variable for link hover color in Customizer
• #10256: Use @navbar-default-brand-color within the @navbar-default-brand-hover-color variable
• #10257: Remove filter on navbars in theme.less so that dropdowns can be triggered in IE<10
• #10265: Scope background-image reset to Bootstrap buttons and form controls only to avoid Android Firefox bug
• #10336: Replace non-ASCII dash in LESS source file
• #10341: Don't change border color on contextual table classes
• #10399: Add hover styles to text emphasis classes
• #10407: Add line-height to progress bar for proper text alignment within
• #10436: Use @screen-sm variable instead of hardcoded pixel value in type.less
• #10484: Allow for .table-bordered in panels by removing side and bottom margins
• #10516: Use auto positioning for dropdowns in justified nav to fix Firefox rendering
• #10521: Only remove bottom-border from last row of cells in tbody and tfoot within responsive tables
• #10522: Enable use of form validation class on .radio, .checkbox, .radio-inline, and .checkbox-inline
• #10526: Remove custom background on responsive tables and set it in the docs where it should've been originally
• #10560: Remove display: block; from address element since browsers set that to start
• #10590: Mention required jQuery version in docs
• #10601: Use overflow-y: auto; for .navbar-collapse instead of visible to better enable scrolling on Android 4.x devices (see issue for more details on support and gotchas)
• #10620: Remove filter on buttons for IE9 in theme.less due to bleed-through with rounded corners (matches behavior and style of Bootstrap 2.x)
• #10641: Remove unused .accordion-toggle class from docs example
• #10656: Inherit link and caret colors for textual dropdowns in panel headers
• #10694: Remove unnecessary content property from .caret
• #10695: Ensure carets in .nav-pills dropdown links inherit active color
• #10729: Removed the unnecessary override and the !important from .wrap in the sticky footer examples
• #10755: Don't remove quotes around q element by default
• #10778: Use newly-updated Glyphicons to workaround old Android WebKit bug
• #10763: Update html5shiv to v3.7.0
• #10863: Fix check for presence of jQuery
• #10893: Remove comma separating the color and the color-stop in `-web...

v3.0.0

What's new

For those who haven't been following along too closely, here's a recap of all the biggest changes shipping with Bootstrap 3:

• New design and an optional theme! With v3, we've gone flat. Don't call it a trend—it's all about customization, folks. Since we simplified the aesthetics though, we thought it'd help to have an optional theme. To use it, check out the Bootstrap theme example.
• Mobile first and always responsive! Nearly everything has been redesigned and rebuilt to start from your handheld devices and scale up.
• Brand new Customizer! It's been redesigned, is now compiled in the browser instead of Heroku, has better dependency support, and even has built-in error handling. Better yet, we now save your customizations to an anonymous Gist for easy reuse, sharing, and modifications.
• Better box model by default. Everything in Bootstrap gets box-sizing: border-box, making for easier sizing options and an enhanced grid system.
• Super-powered grid system. With four tiers of grid classes—phones, tablets, desktops, and large desktops—you can do some super crazy awesome layouts.
• Rewritten JavaScript plugins. All events are now namespaced, no-conflict stuff works way better, and more.
• New Glyphicons icon font! While they were gone for a while, we've since restored the Glyphicons to the main repo. In 2.x, they were images, but now they're in font format and include 40 new glyphs.
• Overhauled navbar. It's now always responsive and comes with some super handy and re-arrangable subcomponents.
• Modals are way more responsive. We've overhauled the modal code to make it way more responsive on mobile devices. They now scroll the entire viewport instead of having a max-height.
• Added some components! New to the mix are panels and list groups.
• Removed some components! We've dropped the accordion (replaced with collapsible panels), submenus, typeahead, and a few more small items. (Worth celebrating as much as adding new ones.)
• More consistent base and sizing classes. Buttons, tables, forms, alerts, and more have been updated to have more consistent classes for easier customizer and extensibility.
• Docs have been blown up, yo. We've added a lot of new documentation, not only for our components, but for browser support (including gotchas and bugs), license FAQs, third party support (and workarounds), accessibility, and more.
• Dropped Internet Explorer 7 and Firefox 3.6 support. For Internet Explorer 8, you'll need to include Respond.js for all the media queries to work correctly. You can read more about browser support in the docs.

For our pre-release testers and others who have been following along with the RCs, here's a list of some of the more prominent changes made since RC2:

• Hella bugs have been fixed (duh, right?).
• Restored the Glyphicons icon font.
• Navbars now require a .navbar-default for the standard version.
• Panels now require a .panel-default for the standard gray variation.
• Alerts now require a modifier class (e.g., .alert.alert-warning for the previously default yellow alert).
• Multiple responsive utilities can now be applied to the same element.
• Examples are back in the main repo and have been fully updated.
• Docs have been updated for more consistent placement, naming, etc.
• Customizer compiling bugs have all been fixed.
• The optional theme has been added and is demonstrated in an example.
• Jumbotrons are now made to extend the full width of the viewport with a container inside, but if you reverse that, the jumbotron in a container will be rounded and padded.
• The navbar components have been updated to better account for the presence of containers and more. You'll see some new margin and padding changes, but no markup changes should be required.

Thanks everyone! <3

(P.S. The dist download here includes compiled CSS, JS, and fonts only—no source code or docs.)

v3.0.0 RC2

Overview

Second release candidate for the upcoming Bootstrap 3. For a complete set of changes between RC1 and RC1, see the commit logs. Key changes are summarized below. To check it out, visit http://getbootstrap.com or use one of the download options below.

There's no dedicated ZIP file for the compiled CSS and JS—that falls out of date too quickly.

To stay up to date, download the latest 3.0.0-wip instead of the download options below.

Key changes

• Docs changes:
  • The Customizer is back! Still needs some work, but functionality has been rewritten and will be improved as we head to final release.
  • Added new mention to our browser compatibility docs to highlight the workaround for Internet Explorer 10 in Windows Phone 8 not picking up media queries. See #9171.
  • Added new section to the Getting Started page for documenting third party and addon compatibility issues. See #9175.
  • Added new Accessibility section, lots of new aria and role attributes, and more for improved 508 and WCAG compliancy. See #9186. Also improved used of more semantic HTML5 elements in docs per #9332, #9347, and #9352.
  • Added HTML validation tests, and made any existing failures pass. See #9396.
• Global CSS changes:
  • Update vertical and horizontal gradients to make start and end color parameters come first, then start and end positions. Fixes #9049.
  • Make .pull-right and .pull-left classes use !important to avoid needing overrides due to specificity (like in navbar, button groups, etc). See #8697.
  • Lots of variable additions to components.
  • Updated gradients to not include background-color for improved use of rgba() colors within mixins. See #8877
• Grid system:
  • Overhauled grid system to include four tiers instead of the original three of RC1. We now have .col-xs (phones), .col-sm (tablets), .col-md (desktops), and .col-lg (large desktops). Responsive utilities have been updated to match these new tiers as well. See relevant commit.
  • .rows only have negative left and right margins if they sit within a .container. This resolves the horizontal scrollbar issue for folks with full page containers (restoring the full behavior of the old fluid container from 2.x). See #8959.
  • Grid now includes offset, push, and pull classes for each break point See #8974.
  • Updated mixins to include ability to specify gutter width as a second parameter. See #8935.
• Buttons:
  • Buttons and inputs, and their large counterparts, are now a bit shorter.
  • New default button styles and higher contrast on :hover and :active states. Fixes #8786.
  • New classes for size modifier classes—instead of .btn-mini, .btn-small, or .btn-large, we now have .btn-xs, .btn-sm, and .btn-lg. See #9056.
  • New button group sizing classes: just add .btn-group-xs, .btn-group-sm, or .btn-group-lg to any .btn-group and you're good to go. See #9295.
• Forms:
  • Similar to the new button classes, we have new input size classes: .input-sm and .input-lg. See #9056.
  • Input focus states now generated via variable and mixin. Use the @input-focus-border variable and .form-control-focus mixin to generate a custom border-color and box-shadow.
• Size modifier classes for large and small components—including buttons, form inputs, pagination, and wells—have all been standardized to use -sm or -lg. See #9056.
  • Inline forms now require the use of .form-group, per #9382, to properly align and size all (native and custom) form controls. This also helps make form markup more consistent and flexible (just swap a class), so woohoo!
  • Added .static-form-control to account for static, placeholder text in horizontal form layouts. Fixes #8150.
  • New input group sizing classes: just add .input-group-sm or .input-group-lg to any .input-group and you're good to go. See #9295.
• Dropped accordion for updated panel.
  • We've removed the accordion and instead chosen to extend the panel component to provide the same functionality. See #9404.
• Navbar:
  • Overhauled navbar to always be responsive and mobile first.
    • Navbars now require a .navbar-header to wrap up brand and toggle.
    • .nav-collapse has been renamed to .navbar-collapse and automatically hits a max-height and will overflow to keep your nav content in the same viewport.
    • See details in #9403.
  • Navbar's no longer use .pull-left or .pull-right, but rather .navbar-left and .navbar-right. This avoids issues with specificity due to chaining classes and enables easier styling.
• Miscellaneous component changes:
  • Alerts that are to be dismissed now require .alert-dismissable to properly pad the alert and align the close button. See #9310.
  • Responsive utilities are now mixin-able thanks to #9211.
  • Dropped .alert-block for a simpler .alert.
  • Linked panel titles now inherit their color. Fixes #9061.
  • List groups in panels no longer require .list-group-flush.
  • Labels now require .label-default for the "default" gray option. See #9123.
  • Labels now collapse automatically (not in IE8) when empty. See #9241.

v3.0.0 RC1

First release candidate for the upcoming Bootstrap 3. For a complete set of changes and migration help, visit the BS3 pull request and read through the opening comment.

To check it out, visit http://getbootstrap.com or use one of the download options below. bs-v3.0.0-rc1-dist.zip is the compiled CSS and JavaScript (you may also just download the entire source code.

<3

v2.3.2

Updated tag to bump the jQuery dependency in Bower and bump Recess to 1.1.9.

Original 2.3.2 tag fixed dropdown for firefox (middleclick) and mobile. (May 17, 2013)

v2.3.1

Patch release for @fat's n00bery

• fix missing event type in dropdown
• fix delegated data-attrs for popover/tooltip
• make carousel actually pause when you click cycle
• fix jshint ref in makefile
• fix trying to remove backdrop when no backdrop

v2.3.0

Minor release to add carousel indicators, improve tooltips, improve dev setup, and fix hella bugs.

• Repository changes:
  • Local instead of global dependencies for our makefile and install process. Now getting started is way easier—just run npm install.
  • Upgraded to jQuery 1.9. No changes were needed, but we did upgrade the included jQuery file to the latest release.
  • Moved changelog to be within the repo instead of as a wiki page.
• New and improved features:
  • Added carousel indicators! Add the HTML and it automagically works.
  • Added container option to tooltips. The default option is still insertAfter, but now you may specify where to insert tooltips (and by extension, popovers) with the optional container parameter.
  • Improved popovers now utilize max-width instead of width, have been widened from 240px to 280px, and will automatically hide the title if one has not been set via CSS :empty selector.
  • Improved tooltip alignment on edges with #6713.
  • Improved accessibility for links in all components. After merging #6441, link hover states now apply to the :focus state as well. This goes for basic <a> tags, as well as buttons, navs, dropdowns, and more.
  • Added print utility classes to show and hide content between screen and print via CSS.
  • Updated input groups to make them behave more like default form controls. Added display: inline-block;, increased margin-bottom, and added vertical-align: middle; to match <input> styles.
  • Added .horizontal-three-colors() gradient mixin (with example in the CSS tests file).
  • Added .text-left, .text-center, and .text-right utility classes for easy typographic alignment.
  • Added @ms-viewport so IE10 can use responsive CSS when in split-screen mode.
• Docs changes:
  • Added new justified navigation example.
  • Added sticky footer with fixed navbar example.

See more on the 2.3.0 pull request.

v2.2.2

Bugfix release addressing docs, CSS, and some JavaScript issues. Key changes include:

• Docs:
  • Assets (illustrations and examples) are now retina-ready.
  • Replaced Placehold.it with Holder.js, a client-side and retina-ready placeholder image tool.
• Dropdowns: Temporary fix added for dropdowns on mobile to prevent them from closing early.
• Popovers:
  • No longer inherits font-size: 0; when placed in button groups.
  • Arrows refactored to work in IE8, and use less code.
  • Plugin no longer inserts popover content into a <p>, but rather directly into .popover-content.
• Labels and badges: Now automatically collapse if they have no content.
• Tables: Nesting support with .table-bordered and .table-striped greatly improved.
• Typeahead:
  • Now inserts dropdown menu after the input instead of at the close of the document.
  • Hitting escape will place focus back on the <input>.
• Print styles, from HTML5 Boilerplate, have been added.

See more on the 2.2.2 milestone.

v2.2.1

Hotfix release to address the carousel bug reports.