src/scss/bootstrap-4.0.0-alpha.6/docs/getting-started/download.md

   1 ---
   2 layout: docs
   3 title: Download
   4 description: Download Bootstrap's compiled CSS and JavaScript, source code, or include it with your favorite package manager.
   5 group: getting-started
   6 ---
   7
   8 **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.
   9
  10 ## Contents
  11
  12 * Will be replaced with the ToC, excluding the "Contents" header
  13 {:toc}
  14
  15 ## Bootstrap CSS and JS
  16
  17 **Download Bootstrap's ready-to-use code to easily drop into your project.** Includes compiled and minified versions of all our CSS bundles (default, grid only, or Reboot only) and JavaScript plugins. Doesn't include documentation or source files.
  18
  19 <a href="{{ site.download.dist }}" class="btn btn-lg btn-bs" onclick="ga('send', 'event', 'Getting started', 'Download', 'Download Bootstrap');">Download Bootstrap</a>
  20
  21 ## Source files
  22 **Want to compile Bootstrap with your project's asset pipeline?** Choose this option to download our source Sass, JavaScript, and documentation files. Requires a Sass compiler, [Autoprefixer](https://github.com/postcss/autoprefixer), [postcss-flexbugs-fixes](https://github.com/luisrudge/postcss-flexbugs-fixes), and [some setup]({{ site.baseurl }}/getting-started/build-tools/#tooling-setup).
  23
  24 <a href="{{ site.download.source }}" class="btn btn-bs" onclick="ga('send', 'event', 'Getting started', 'Download', 'Download source');">Download source</a>
  25
  26 ## Bootstrap CDN
  27
  28 Skip the download and use the Bootstrap CDN to deliver Bootstrap's compiled CSS and JS to your project.
  29
  30 {% highlight html %}
  31 <link rel="stylesheet" href="{{ site.cdn.css }}" integrity="{{ site.cdn.css_hash }}" crossorigin="anonymous">
  32 <script src="{{ site.cdn.js }}" integrity="{{ site.cdn.js_hash }}" crossorigin="anonymous"></script>
  33 {% endhighlight %}
  34
  35 ## Package managers
  36
  37 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, [Autoprefixer](https://github.com/postcss/autoprefixer), and [postcss-flexbugs-fixes](https://github.com/luisrudge/postcss-flexbugs-fixes)** for a setup that matches our official compiled versions.
  38
  39 ### npm
  40
  41 Install Bootstrap in your Node powered apps with [the npm package](https://www.npmjs.org/package/bootstrap):
  42
  43 {% highlight bash %}
  44 npm install bootstrap@{{ site.current_version }}
  45 {% endhighlight %}
  46
  47 `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.
  48
  49 Bootstrap's `package.json` contains some additional metadata under the following keys:
  50
  51 - `sass` - path to Bootstrap's main [Sass](http://sass-lang.com/) source file
  52 - `style` - path to Bootstrap's non-minified CSS that's been precompiled using the default settings (no customization)
  53
  54 ### RubyGems
  55
  56 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):
  57
  58 {% highlight ruby %}
  59 gem 'bootstrap', '~> 4.0.0.alpha6'
  60 {% endhighlight %}
  61
  62 Alternatively, if you're not using Bundler, you can install the gem by running this command:
  63
  64 {% highlight bash %}
  65 gem install bootstrap -v 4.0.0.alpha6
  66 {% endhighlight %}
  67
  68 [See the gem's README](https://github.com/twbs/bootstrap-rubygem/blob/master/README.md) for further details.
  69
  70 ### Composer
  71
  72 You can also install and manage Bootstrap's Sass and JavaScript using [Composer](https://getcomposer.org):
  73
  74 {% highlight bash %}
  75 composer require twbs/bootstrap:{{ site.current_version }}
  76 {% endhighlight %}
  77
  78 ### Bower
  79
  80 Install and manage Bootstrap's Sass and JavaScript using [Bower](https://bower.io).
  81
  82 {% highlight bash %}
  83 bower install bootstrap#v{{ site.current_version }}
  84 {% endhighlight %}
  85
  86 ### NuGet
  87
  88 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):
  89
  90 {% highlight powershell %}
  91 Install-Package bootstrap -Pre
  92 {% endhighlight %}
  93
  94 {% highlight powershell %}
  95 Install-Package bootstrap.sass -Pre
  96 {% endhighlight %}
  97
  98 The `-Pre` is required until Bootstrap v4 has a stable release.