download.md 3.53 KB
Newer Older
1
---
Mark Otto's avatar
Mark Otto committed
2
layout: docs
3
title: Download
4
group: getting-started
5
6
---

Mark Otto's avatar
Mark Otto committed
7
**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.
8

Mark Otto's avatar
Mark Otto committed
9
10
11
12
13
<div class="row m-t-md">
  <div class="col-sm-6">
{% markdown %}
### Compiled
Download just the compiled and minified CSS and JavaScript. Doesn't include any documentation or original source files.
Mark Otto's avatar
Mark Otto committed
14

15
{% comment %}
Mark Otto's avatar
Mark Otto committed
16
<a href="{{ site.download.dist }}" class="btn btn-bs btn-outline" onclick="ga('send', 'event', 'Getting started', 'Download', 'Download compiled');">Download Bootstrap</a>
17
18
{% endcomment %}
<span class="text-muted">Coming soon!</span>
Mark Otto's avatar
Mark Otto committed
19
{% endmarkdown %}
Mark Otto's avatar
Mark Otto committed
20
  </div>
Mark Otto's avatar
Mark Otto committed
21
22
23
  <div class="col-sm-6">
{% markdown %}
### Source files
24
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).**
Mark Otto's avatar
Mark Otto committed
25
26
27

<a href="{{ site.download.source }}" class="btn btn-bs btn-outline" onclick="ga('send', 'event', 'Getting started', 'Download', 'Download source');">Download source</a>
{% endmarkdown %}
Mark Otto's avatar
Mark Otto committed
28
29
  </div>
</div>
30

Mark Otto's avatar
Mark Otto committed
31
32
## Package managers

Mark Otto's avatar
Mark Otto committed
33
34
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.

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

Mark Otto's avatar
Mark Otto committed
39
### Bower
40

Mark Otto's avatar
Mark Otto committed
41
Install and manage Bootstrap's Sass and JavaScript using [Bower](http://bower.io).
42
43
44

{% highlight bash %}$ bower install bootstrap{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
45
### npm
46

Mark Otto's avatar
Mark Otto committed
47
Install Bootstrap in your Node powered apps with [the npm package](https://www.npmjs.org/package/bootstrap):
48
49

{% highlight bash %}$ npm install bootstrap{% endhighlight %}
Mark Otto's avatar
Mark Otto committed
50

Mark Otto's avatar
Mark Otto committed
51
`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.
Mark Otto's avatar
Mark Otto committed
52

Mark Otto's avatar
Mark Otto committed
53
54
55
56
57
Bootstrap's `package.json` contains some additional metadata under the following keys:

- `less` - path to Bootstrap's main [Less](http://lesscss.org) source file
- `style` - path to Bootstrap's non-minified CSS that's been precompiled using the default settings (no customization)

Mark Otto's avatar
Mark Otto committed
58
### Meteor
Mark Otto's avatar
Mark Otto committed
59
60
61
62
63

{% highlight bash %}
$ meteor add twbs:bootstrap
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
64
### Composer
Mark Otto's avatar
Mark Otto committed
65

Mark Otto's avatar
Mark Otto committed
66
You can also install and manage Bootstrap's Sass and JavaScript using [Composer](https://getcomposer.org):
Mark Otto's avatar
Mark Otto committed
67

Mark Otto's avatar
Mark Otto committed
68
69
70
71
{% highlight bash %}
$ composer require twbs/bootstrap
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
72

Mark Otto's avatar
Mark Otto committed
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
## Custom builds

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

<div class="row">
  <div class="col-sm-4">
    <h3>Reboot</h3>
    <p>Includes variables/mixins, Normalize, and Reboot. No JavaScript.</p>
    <a class="btn btn-bs btn-outline" href="#">Download</a>
  </div>
  <div class="col-sm-4">
    <h3>Grid only</h3>
    <p>Includes variables/mixins and our grid system. No JavaScript.</p>
    <a class="btn btn-bs btn-outline" href="#">Download</a>
  </div>
  <div class="col-sm-4">
    <h3>Flexbox</h3>
    <p>All of Bootstrap with flexbox enabled and <strong>lower browser support</strong>.</p>
    <a class="btn btn-bs btn-outline" href="#">Download</a>
  </div>
</div>