| commit | author | age | ||
| 83c3f6 | 1 | --- |
| SP | 2 | layout: docs |
| 3 | title: Download | |
| 4 | description: Download Bootstrap to get the compiled CSS and JavaScript, source code, or include it with your favorite package managers like npm, RubyGems, and more. | |
| 5 | group: getting-started | |
| 6 | toc: true | |
| 7 | --- | |
| 8 | ||
| 9 | ## Compiled CSS and JS | |
| 10 | ||
| 11 | Download ready-to-use compiled code for **Bootstrap v{{ site.current_version}}** to easily drop into your project, which includes: | |
| 12 | ||
| 13 | - Compiled and minified CSS bundles (see [CSS files comparison]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/contents/#css-files)) | |
| 14 | - Compiled and minified JavaScript plugins | |
| 15 | ||
| 16 | This doesn't include documentation, source files, or any optional JavaScript dependencies (jQuery and Popper.js). | |
| 17 | ||
| 18 | <a href="{{ site.download.dist }}" class="btn btn-bd-primary" onclick="ga('send', 'event', 'Getting started', 'Download', 'Download Bootstrap');">Download</a> | |
| 19 | ||
| 20 | ## Source files | |
| 21 | ||
| 22 | Compile Bootstrap with your own asset pipeline by downloading our source Sass, JavaScript, and documentation files. This option requires some additional tooling: | |
| 23 | ||
| 24 | - Sass compiler (Libsass or Ruby Sass is supported) for compiling your CSS. | |
| 25 | - [Autoprefixer](https://github.com/postcss/autoprefixer) for CSS vendor prefixing | |
| 26 | ||
| 27 | Should you require [build tools]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/build-tools/#tooling-setup), they are included for developing Bootstrap and its docs, but they're likely unsuitable for your own purposes. | |
| 28 | ||
| 29 | <a href="{{ site.download.source }}" class="btn btn-bd-primary" onclick="ga('send', 'event', 'Getting started', 'Download', 'Download source');">Download source</a> | |
| 30 | ||
| 31 | ## BootstrapCDN | |
| 32 | ||
| 33 | Skip the download with [BootstrapCDN](https://www.bootstrapcdn.com/) to deliver cached version of Bootstrap's compiled CSS and JS to your project. | |
| 34 | ||
| 35 | {% highlight html %} | |
| 36 | <link rel="stylesheet" href="{{ site.cdn.css }}" integrity="{{ site.cdn.css_hash }}" crossorigin="anonymous"> | |
| 37 | <script src="{{ site.cdn.js }}" integrity="{{ site.cdn.js_hash }}" crossorigin="anonymous"></script> | |
| 38 | {% endhighlight %} | |
| 39 | ||
| 40 | If you're using our compiled JavaScript, don't forget to include CDN versions of jQuery and Popper.js before it. | |
| 41 | ||
| 42 | {% highlight html %} | |
| 43 | <script src="{{ site.cdn.jquery }}" integrity="{{ site.cdn.jquery_hash }}" crossorigin="anonymous"></script> | |
| 44 | <script src="{{ site.cdn.popper }}" integrity="{{ site.cdn.popper_hash }}" crossorigin="anonymous"></script> | |
| 45 | {% endhighlight %} | |
| 46 | ||
| 47 | ## Package managers | |
| 48 | ||
| 49 | Pull in Bootstrap's **source files** into nearly any project with some of the most popular package managers. No matter the package manager, Bootstrap will **require a Sass compiler and [Autoprefixer](https://github.com/postcss/autoprefixer)** for a setup that matches our official compiled versions. | |
| 50 | ||
| 51 | ### npm | |
| 52 | ||
| 53 | Install Bootstrap in your Node.js powered apps with [the npm package](https://www.npmjs.com/package/bootstrap): | |
| 54 | ||
| 55 | {% highlight sh %} | |
| 56 | npm install bootstrap | |
| 57 | {% endhighlight %} | |
| 58 | ||
| 59 | `require('bootstrap')` will load all of Bootstrap's jQuery plugins onto the jQuery object. The `bootstrap` module itself does not export anything. You can manually load Bootstrap's jQuery plugins individually by loading the `/js/*.js` files under the package's top-level directory. | |
| 60 | ||
| 61 | Bootstrap's `package.json` contains some additional metadata under the following keys: | |
| 62 | ||
| 63 | - `sass` - path to Bootstrap's main [Sass](https://sass-lang.com/) source file | |
| 64 | - `style` - path to Bootstrap's non-minified CSS that's been precompiled using the default settings (no customization) | |
| 65 | ||
| 66 | ### yarn | |
| 67 | ||
| 68 | Install Bootstrap in your Node.js powered apps with [the yarn package](https://yarnpkg.com/en/package/yarn): | |
| 69 | ||
| 70 | {% highlight sh %} | |
| 71 | yarn add bootstrap | |
| 72 | {% endhighlight %} | |
| 73 | ||
| 74 | ### RubyGems | |
| 75 | ||
| 76 | Install Bootstrap in your Ruby apps using [Bundler](https://bundler.io/) (**recommended**) and [RubyGems](https://rubygems.org/) by adding the following line to your [`Gemfile`](https://bundler.io/gemfile.html): | |
| 77 | ||
| 78 | {% highlight ruby %} | |
| 79 | gem 'bootstrap', '~> {{ site.current_ruby_version }}' | |
| 80 | {% endhighlight %} | |
| 81 | ||
| 82 | Alternatively, if you're not using Bundler, you can install the gem by running this command: | |
| 83 | ||
| 84 | {% highlight sh %} | |
| 85 | gem install bootstrap -v {{ site.current_ruby_version }} | |
| 86 | {% endhighlight %} | |
| 87 | ||
| 88 | [See the gem's README](https://github.com/twbs/bootstrap-rubygem/blob/master/README.md) for further details. | |
| 89 | ||
| 90 | ### Composer | |
| 91 | ||
| 92 | You can also install and manage Bootstrap's Sass and JavaScript using [Composer](https://getcomposer.org/): | |
| 93 | ||
| 94 | {% highlight sh %} | |
| 95 | composer require twbs/bootstrap:{{ site.current_version }} | |
| 96 | {% endhighlight %} | |
| 97 | ||
| 98 | ### NuGet | |
| 99 | ||
| 100 | If you develop in .NET, you can also install and manage Bootstrap's [CSS](https://www.nuget.org/packages/bootstrap/) or [Sass](https://www.nuget.org/packages/bootstrap.sass/) and JavaScript using [NuGet](https://www.nuget.org/): | |
| 101 | ||
| 102 | {% highlight powershell %} | |
| 103 | Install-Package bootstrap | |
| 104 | {% endhighlight %} | |
| 105 | ||
| 106 | {% highlight powershell %} | |
| 107 | Install-Package bootstrap.sass | |
| 108 | {% endhighlight %} | |
