1
0
Fork 0
mirror of https://github.com/twbs/bootstrap.git synced 2022-11-09 12:25:43 -05:00
twbs--bootstrap/docs/getting-started/download.md
Chris Rebert 0fe1d1ee3d Add RubyGems section to "Download" docs
Closes #17291 by finishing the last remaining task.
Also reorders the sections in the "Download" docs.

[skip sauce]
2015-12-17 13:29:58 -08:00

4.6 KiB

layout title group
docs Download getting-started

Bootstrap v{{ site.current_version}} is available for download in several ways, including some of your favorite package managers. Choose from the options below to snag just what you need.

{% markdown %} ### Compiled Download just the compiled and minified CSS and JavaScript. Doesn't include any documentation or original source files.

{% comment %} Download Bootstrap {% endcomment %} Coming soon! {% endmarkdown %}

{% markdown %} ### Source files Download everything: source Sass, JavaScript, and documentation files. **Requires a Sass compiler, [Autoprefixer](https://github.com/postcss/autoprefixer), and [some setup]({{ site.baseurl }}/getting-started/build-tools/#tooling-setup).**

Download source {% endmarkdown %}

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.

{% callout warning %} Heads up! Not all package managers have the v4 alpha published yet, but we should have them up shortly! {% endcallout %}

npm

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

{% highlight bash %} $ npm install bootstrap@{{ site.current_version }} {% 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', '~> 4.0.0.alpha3' {% endhighlight %}

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

{% highlight bash %} $ gem install bootstrap -v 4.0.0.alpha3 {% endhighlight %}

See the gem's README for further details.

Meteor

{% highlight bash %} $ meteor add twbs:bootstrap@={{ site.current_version }} {% endhighlight %}

Composer

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

{% highlight bash %} $ composer require twbs/bootstrap {% endhighlight %}

Bower

Install and manage Bootstrap's Sass and JavaScript using Bower.

{% highlight bash %} $ bower install bootstrap#v{{ 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 %} PM> Install-Package bootstrap -Pre PM> Install-Package bootstrap.sass -Pre {% endhighlight %}

The -Pre is required until Bootstrap v4 has a stable release.

Custom builds

Need only a part of Bootstrap's CSS or JS? Use one of the custom builds to snag just what you need.

Reboot

Includes variables/mixins, Normalize, and Reboot. No JavaScript.

Download

Grid only

Includes variables/mixins and our grid system. No JavaScript.

Download

Flexbox

All of Bootstrap with flexbox enabled and lower browser support.

Download