PHPackages                             inki/bootunstrap - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. inki/bootunstrap

ActiveLibrary[Utility & Helpers](/categories/utility)

inki/bootunstrap
================

maintainable Bootstrap integration made easy

144CSS

Since Mar 16Pushed 12y ago2 watchersCompare

[ Source](https://github.com/inkidotcom/bootunstrap)[ Packagist](https://packagist.org/packages/inki/bootunstrap)[ RSS](/packages/inki-bootunstrap/feed)WikiDiscussions master Synced 4d ago

READMEChangelogDependenciesVersions (2)Used By (0)

\#Bootunstrap

Information:
------------

[](#information)

Bootstrap based project that keeps Bootstrap as a separate submodule.

Basically, this allows you to modify the local versions of variables.less, bootstrap.less and responsive.less (or even override other bootstrap .less files) while keeping the original bootstrap repository isolated and easily updateable (without crazy merges and such).

Once you make changes to your own variables.less file, simply run `$ ./build.sh bootstrap`

If there's an update to bootstrap, run `$ ./build.sh update` and re-build `$ ./build.sh bootstrap`

Your changes remain intact, as long as no major architectural changes have happened in bootstrap.

Dependancies:
-------------

[](#dependancies)

You'll need to have [Git](http://git-scm.com/) and [NodeJS](http://nodejs.org/) installed along with the following Node Packages:

[Recess](https://github.com/twitter/recess) - A simple and attractive code quality tool for CSS built on top of LESS

[UglifyJS](https://github.com/mishoo/UglifyJS) - JavaScript parser / mangler / compressor / beautifier library for NodeJS

[ShellJS](https://github.com/arturadib/shelljs) - Portable Unix shell commands for Node.js

```
$ sudo npm install recess uglify-js shelljs -g

```

\*The build script that currently does all the build magic is written as a shell script so it may only work in \*NIX sytems (should work with cygwin but haven't fully tested this.)

You'll want to make sure your **NODE\_PATH** environment variable is set up

```
$ echo 'export NODE_PATH="'$(npm root -g)'"' >> ~/.bashrc && . ~/.bashrc

```

In my case, I use **~/.profile** so I actually use...

```
$ echo 'export NODE_PATH="'$(npm root -g)'"' >> ~/.profile && . ~/.profile

```

QUICK-START
-----------

[](#quick-start)

Checkout the Bootunstrap project and build

```
$ git clone https://github.com/inkidotcom/bootunstrap.git bootunstrap
$ cd bootunstrap
$ git submodule update --init
$ ./build.sh bootstrap

```

open index.html in your browser

Build Script
------------

[](#build-script)

You can run the build script without any options and you will be presented with the currently available options **clean**, **bootstrap**, **update** or **quit**

```
$ ./build.sh

```

Or, you can run a command directly by passing it as an argument

```
$ ./build.sh bootstrap

```

### Commands:

[](#commands)

clean : removes local Bootstrap files (css/bootstrap, img/bootstrap, js/bootstrap)

```
$ ./build.sh clean

```

bootstrap : compiles Bootstrap css and js and copies over Bootstrap img assets

```
$ ./build.sh bootstrap

```

update : updates Bootstrap to master or branch as specified by second parameter

```
$ ./build.sh update
$ ./build.sh update 2.2.2-wip

```

Authors:
--------

[](#authors)

**Manny Ramirez**

- [twiter](http://twitter.com/inki)
- [github](https://github.com/inkidotcom)

Copyright and license
---------------------

[](#copyright-and-license)

Copyright 2012 Manny Ramirez.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

```
http://www.apache.org/licenses/LICENSE-2.0

```

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/f9cca9268371ecc3fbc58aee7761aabc14bfe2b61e1de49f7505cd7a8eb9b65a?d=identicon)[inki](/maintainers/inki)

---

Top Contributors

[![inkidotcom](https://avatars.githubusercontent.com/u/100466?v=4)](https://github.com/inkidotcom "inkidotcom (11 commits)")

### Embed Badge

![Health badge](/badges/inki-bootunstrap/health.svg)

```
[![Health](https://phpackages.com/badges/inki-bootunstrap/health.svg)](https://phpackages.com/packages/inki-bootunstrap)
```

###  Alternatives

[symfonycasts/sass-bundle

Delightful Sass Support for Symfony + AssetMapper

46659.0k4](/packages/symfonycasts-sass-bundle)[slash2nl/nova-back-button

A Laravel Nova card to display a back button.

18213.1k](/packages/slash2nl-nova-back-button)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)