twbs--bootstrap/docs/4.0/getting-started/download.md

layout	title	description	group	toc
docs	Download	Download Bootstrap to get the compiled CSS and JavaScript, source code, or include it with your favorite package managers like npm, RubyGems, and more.	getting-started	true

Compiled CSS and JS

Download ready-to-use compiled code for Bootstrap v{{ site.current_version}} to easily drop into your project, which includes:

• Compiled and minified CSS bundles (see [CSS files comparison]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/contents/#comparison-of-css-files))
• Compiled and minified JavaScript plugins

This doesn't include documentation, source files, or any optional JavaScript dependencies (jQuery and Popper.js).

Download

Source files

Compile Bootstrap with your own asset pipeline by downloading our source Sass, JavaScript, and documentation files. This option requires some additional tooling:

• Sass compiler (Libsass or Ruby Sass is supported) for compiling your CSS.
• Autoprefixer for CSS vendor prefixing

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.

Download source

BootstrapCDN

Skip the download with BootstrapCDN to deliver cached version of Bootstrap's compiled CSS and JS to your project.

{% highlight html %}

{% endhighlight %}

If you're using our compiled JavaScript, don't forget to include CDN versions of jQuery and Popper.js before it.

{% highlight html %}

{% endhighlight %}

Package managers

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 for a setup that matches our official compiled versions.

npm

Install Bootstrap in your Node.js powered apps with the npm package:

{% highlight sh %} npm install bootstrap {% endhighlight %}

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.

Bootstrap's package.json contains some additional metadata under the following keys:

• sass - path to Bootstrap's main Sass source file
• style - path to Bootstrap's non-minified CSS that's been precompiled using the default settings (no customization)

RubyGems

Install Bootstrap in your Ruby apps using Bundler (recommended) and RubyGems by adding the following line to your Gemfile:

{% highlight ruby %} gem 'bootstrap', '~> {{ site.current_ruby_version }}' {% endhighlight %}

Alternatively, if you're not using Bundler, you can install the gem by running this command:

{% highlight sh %} gem install bootstrap -v {{ site.current_ruby_version }} {% endhighlight %}

See the gem's README for further details.

Composer

You can also install and manage Bootstrap's Sass and JavaScript using Composer:

{% highlight sh %} composer require twbs/bootstrap:{{ site.current_version }} {% endhighlight %}

NuGet

If you develop in .NET, you can also install and manage Bootstrap's CSS or Sass and JavaScript using NuGet:

{% highlight powershell %} Install-Package bootstrap {% endhighlight %}

{% highlight powershell %} Install-Package bootstrap.sass {% endhighlight %}