Extends Twitter Bootstrap with additional lightweight JavaScript controls. Easy to install, customize, update, and optimize. All functionality covered by live documentation and unit tests.
JavaScript HTML CSS
Latest commit 7cb7900 Nov 8, 2016 @cormacmccarthy cormacmccarthy committed on GitHub Merge pull request #1896 from ExactTarget/greenkeeper-bower-1.8.0
Update bower to version 1.8.0 πŸš€
Permalink
Failed to load latest commit information.
.github (GH1743) adds pull request and issue templates Feb 29, 2016
dev in an attempt to reduce the churn on dev.html let us try this Feb 10, 2015
dist release 3.15.9 Nov 7, 2016
fonts fixing fonts issue Jul 2, 2014
grunt () streamlines release prompts. Documents ssh reqs Nov 7, 2016
js (GH1884) replaces JS loader with SVG. Stubs out old JS methods for ba… Oct 26, 2016
less Merge branch 'master' into GH1884---use-mc-theme-svg-for-loader Oct 26, 2016
markup update tree markup to have alert role on span May 17, 2016
templates (GH1887) adds ability to accomodate secondary text in template for wi… Oct 24, 2016
test (GH1891) updates to qunit 2 Oct 31, 2016
.bithoundrc (1037---ignore-dist-in-bithound) adds /dist/ (and others) to ignore Feb 5, 2015
.eslintrc (GH1841) allows undefined Aug 19, 2016
.gitignore (master) more plumbing fixes for release Sep 18, 2015
.jshintrc value of `latedef` not worth refactoring Jan 19, 2016
.travis.yml update travis yml to node version as project Nov 4, 2016
CHANGELOG.md () streamlines release prompts. Documents ssh reqs Nov 7, 2016
CNAME Create CNAME Oct 21, 2014
CONTRIBUTING.md pruning and reorganizing docs for consistency with SLDS Sep 22, 2016
GITHUB_TOKEN.json.template (master) fixes manual release notes task Feb 24, 2016
Gruntfile.js (GH1891) updates to qunit 2 Oct 31, 2016
LICENSE 3.0.0-wip: updating license Aug 15, 2014
Procfile Move node_module archiving to Procfile Jun 2, 2015
README.md Update README.md Oct 31, 2016
RELEASE.md () streamlines release prompts. Documents ssh reqs Nov 7, 2016
app.json Add Heroku generated app.json Sep 23, 2016
bower.json (GH1891) updates to qunit 2 Oct 31, 2016
data.js Tree: Hide chervron for folder that doesn't have children #860 Nov 26, 2014
devserver.js Update server to use connect serve-static Jan 16, 2015
index.css Fixes #1311 Jul 28, 2015
index.html Merge branch 'master' into GH1884---use-mc-theme-svg-for-loader Oct 26, 2016
index.js Merge branch 'master' into GH1884---use-mc-theme-svg-for-loader Oct 26, 2016
package.js updates version numbers and changelog Sep 23, 2016
package.json Merge branch 'master' into greenkeeper-bower-1.8.0 Nov 8, 2016
postinstall.js Transformed postinstall bash script into node script Aug 6, 2015
sauce_browsers.yml remove iOS Safari testing Nov 4, 2016

README.md

Sanity Checks

Fuel UX Bower version npm version Build Status devDependency Status

Selenium Test Status

Fuel UX extends Bootstrap 3 with additional lightweight JavaScript controls. It is actively maintained by members of Salesforce Marketing Cloud, with the support and involvement of the community.

More thorough documentation and guides available at http://getfuelux.com

Documentation

Fuel UX documentation is built with Jekyll and publicly hosted on GitHub Pages at http://getfuelux.com. More details on setting up Jekyll and running docs locally can be found in our CONTRIBUTING.md documentation.

Contributing

Please read the CONTRIBUTING.md first.

Obtaining Fuel UX

NPM is the recommended method for obtaining Fuel UX.

npm install fuelux

You can also use on of the following methods:

  • Bower bower install fuelux (update with bower update fuelux).
  • Volo volo add fuelux (update with volo add -f fuelux).
  • Clone via git git clone https://github.com/ExactTarget/fuelux/
    • Cloning the repository ensures you can apply future updates to Fuel UX easily, but requires to you manage its dependencies on your own.
  • Download a .zip archive.

Using Fuel UX

Fuel UX can be used with an existing page via CDN or installed in a project.

Read the Getting started page for more detailed information on the framework contents, templates, examples, and more.

Required fuelux class

Add fuelux class to the portion of the page using Fuel UX, usually the body.

<body class="fuelux">

Required Dependencies

Fuel UX is dependent upon Bootstrap 3 and jQuery. If you installed by cloning the repo or by downloading a .zip archive, you'll also want to grab these dependencies, as it won't work without them.

For other methods of managing dependencies consider AMD support via require.

Ensure all the dependencies are included on the page (eg, such as using the CDN as shown below).

<link href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css" rel="stylesheet">
<link href="//www.fuelcdn.com/fuelux/3.15.8/css/fuelux.min.css" rel="stylesheet">

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.js"></script>
<script src="//maxcdn.bootstrapcdn.com/bootstrap/3.2.1/js/bootstrap.min.js"></script>
<script src="//www.fuelcdn.com/fuelux/3.15.8/js/fuelux.min.js"></script>

What's included

The code you want is in dist/. We provide compiled CSS and JS (like fuelux.*), as well as compiled and minified CSS and JS (like fuelux.min.*) in the dist folder. Icons are provided as fonts.

fuelux/
β”œβ”€β”€ css/
β”‚   β”œβ”€β”€ fuelux.css
β”‚   β”œβ”€β”€ fuelux.min.css
β”œβ”€β”€ js/
β”‚   β”œβ”€β”€ fuelux.js
β”‚   └── fuelux.min.js
└── fonts/
    β”œβ”€β”€ fuelux.eot
    β”œβ”€β”€ fuelux.svg
    β”œβ”€β”€ fuelux.ttf
    └── fuelux.woff

AMD support

We recommend only loading the controls you need (eg fuelux/checkbox).

If using AMD (such as RequireJS), reference the FuelUX directory in your paths configuration, wherever it is located:

require.config({
    paths: {
        'fuelux': 'http://www.fuelcdn.com/fuelux/3.15.8/'
        //...
    }
});

Then list any individual fuel ux controls needed as dependencies within your application modules:

define(function(require) {
    var spinbox = require('fuelux/spinbox');
    //...
});

In instances where you require every module from Fuel UX, you can use fuelux/all instead of listing each module individually.

Fuel UX also supports placing components in their own <script> tags. Be sure to check component dependencies in the controls documentation and put modules in the correct order if you load them in this method. Errors will appear in the console if you have not loaded dependencies correctly ((Repeater)[http://getfuelux.com/javascript.html#repeater-dependencies] and Scheduler are the only components with dependencies currently).

Bugs and Feature Requests

Have a bug or a feature request? Please first review the open issues, then search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

For additional assistance connect with the community.

Previous releases

Documentation for v2.6 has been made available for the time being while folks transition to Bootstrap 3. You can download 2.6 updates (bug fixes only) from the fuelux2 branch.

Community

Philosophy

Our aim is to provide a suite of related but independent projects that help web developers integrate, manage, and customize quality libraries and utilities to more efficiently develop, maintain, test, and distribute their projects. Any improvements or fixes we make to the open source projects, we use will be contributed upstream if they are useful to the rest of the community.

Thank you to all those that have submitted issues and contributed to this library.

Copyright and License

Copyright Β© 2012-2014 Salesforce Marketing Cloud, Inc.

View BSD-3 license.