Skip to content
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 35c3341 May 27, 2016 @interactivellama interactivellama release 3.15.4
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.4 May 27, 2016
fonts fixing fonts issue Jul 2, 2014
grunt Adds link to wiki about release notes step and the required Ruby Gem … Mar 29, 2016
js Merge pull request #1818 from interactivellama/repeater-list-actions May 25, 2016
less use no-js-checkboxes for checkall Apr 20, 2016
markup update tree markup to have alert role on span May 17, 2016
templates update tree markup to have alert role on span May 17, 2016
test Merge pull request #1812 from interactivellama/html-lint-tree-update May 25, 2016
.bithoundrc (1037---ignore-dist-in-bithound) adds /dist/ (and others) to ignore Feb 5, 2015
.gitignore (master) more plumbing fixes for release Sep 18, 2015
.jshintrc value of `latedef` not worth refactoring Jan 19, 2016
.travis.yml Make Travis use node 4 too. Mar 22, 2016
BACKLOG.md Update backlog May 15, 2014
CNAME Create CNAME Oct 21, 2014
DETAILS.md release 3.15.4 May 27, 2016
GITHUB_TOKEN.json.template (master) fixes manual release notes task Feb 24, 2016
Gruntfile.js Update grunt modules with getPackage() Aug 18, 2015
LICENSE 3.0.0-wip: updating license Aug 15, 2014
Procfile Move node_module archiving to Procfile Jun 2, 2015
README.md release 3.15.4 May 27, 2016
RELEASE.md Adds a link to the wiki release page to RELEASE.md Mar 29, 2016
bower.json (GH1737) fixes #1737 puts unit tests for combobox back in Feb 25, 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 (GH1737) fixes #1737 puts unit tests for combobox back in Feb 25, 2016
index.js Update pageChangedEvent to have value and data object May 23, 2016
package.js orphaned version updates May 3, 2016
package.json release 3.15.4 May 27, 2016
postinstall.js Transformed postinstall bash script into node script Aug 6, 2015
sauce_browsers.yml config sauecelabs to latest version of browsers minus ie8 (like BS) Oct 21, 2014
sauce_browsers_tricky.yml Remove FF version and make linux Apr 17, 2014

README.md

Fuel UX

slack channel 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.

To get started, check out http://getfuelux.com!

Table of contents

Using

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.

Use

Add fuelux class to the portion of the page using Fuel UX as seen here.

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.3/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.3/js/fuelux.min.js"></script>

The code you want is in dist

A few ways available to install.

More details for the above can be found here.

What's included

We provide compiled CSS and JS (like fuelux.*), as well as compiled and minified CSS and JS (like fuelux.min.*) in the dist folder. Supporting 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

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 things, as it won't work without them.

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

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.

Documentation

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

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.

Contributing

Before writing code

Writing code

  • Do not edit or commit files in the dist directory. Project maintainers will commit files in the dist directory from time to time. Details on compiling CSS and JavasScript can be found here.
  • Source files are in respective js, less, and fonts directories.
  • Conform to Salesforce Marketing Cloud style guide.
  • Add and/or update unit tests for any new or changed functionality.
  • Test your code at http://localhost:8000/. (start using grunt servefast)
  • Run unit tests with grunt test or in browser at http://localhost:8000/test/ (you'll need to grunt servefast to keep server from quitting on failed unit tests to troubleshoot in browser).

Submitting Pull Requests

All pull requests are validated via Travis CI. If the tests fail and you feel it is a Travis issue, you can trigger a restart.

While grunt can run the included unit tests via PhantomJS, this isn't a substitute for running tests across a variety of browsers and environments. Please be sure to test in as many of the browsers listed in sauce_browsers.yml as you can before contributing.

  • Run grunt to lint & test your code.
  • Write meaningful commit messages.
  • Submit a pull request from your github fork, mentioning the issue your changes fix.
  • Follow your pull request answering questions and making adjustments as appropriate until it is merged.

Read more about contributing to FuelUX

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.

Project Maintainers (a-z)
Stephen James tweetllama on Twitter interactivellama on Github
Christopher McCulloh @cmcculloh on Twitter cmcculloh on Github cormacmccarthy on Github
Kevin Parkerson kevinparkerson on Twitter kevinparkerson on Github
Stephen Williams swilliamsui on Twitter swilliamset on Github
Dave Woodward futuremint on Twitter futuremint on Github

Special thanks to major contributors and active contributors.

And 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.

Something went wrong with that request. Please try again.