moves v2.3.2 to /2/
[bootswatch] / 2 / swatchmaker / README.md
1 Create your own swatch
2 ======================
3
4 1. Download Bootswatch
5 ------
6 Download or clone [Bootswatch](https://github.com/thomaspark/bootswatch).
7
8
9 2. Install Bootstrap
10 ------
11 In terminal, navigate to `/bootswatch/swatchmaker/` and run the command `make bootstrap` to download the latest version of Bootstrap.
12
13
14 3. Install Bootstrap Dependencies
15 ------
16 If you haven't before, [install npm](https://npmjs.org/). Next, navigate to `/bootswatch/swatchmaker/bootstrap/` and type `npm install` to locally install Bootstrap dependencies (uglify-js, jshint, recess, connect, hogan.js).
17
18
19 4. Customize Bootstrap
20 ------
21 Make your customizations to the two files found in `/bootswatch/swatchmaker/swatch/`: `variables.less` and `bootswatch.less`. You can also copy over the less files from an existing theme and modify them.
22
23
24 5. Build Customized Bootstrap
25 ------
26 In `/bootswatch/swatchmaker/`, run `make bootswatch`. The compiled CSS files will be created in `/bootswatch/swatchmaker/swatch/`.
27
28 You can run the watcher to automatically build Bootstrap whenever changes are saved with `make watcher` (Requires `gem install directory_watcher`).
29
30
31 6. Reset Bootstrap
32 ------
33 If you want to reset `variables.less` and `bootswatch.less` to defaults, run `make default`.