Fuel UX extends Twitter Bootstrap with additional lightweight JavaScript controls. Other benefits include easy installation into web projects, integrated scripts for customizing Bootstrap and Fuel UX, simple updates, and solid optimization for deployment. All functionality is covered by live documentation and unit tests.

Fuel UX provides all of the styles and plugins from the revolutionary Twitter Bootstrap project, with the following additions:

• Fuel UX JavaScript controls (with unit tests) see them live
  • Checkbox - consistent cross-browser cross-platform look and feel for checkbox elements
  • Combobox - combines input and dropdown for easy and flexible data selection
  • Datagrid - renders data in a table with paging, sorting, and searching
  • Pillbox - manages selected items with color-coded text labels
  • Radio - consistent cross-browser cross-platform look and feel for radio elements
  • Search - combines input and button for integrated search interaction
  • Select - extends button dropdown with the ability to set and retrieve the selected item
  • Spinner - provides convenient numeric input with increment and decrement buttons
  • Tree - renders data in a tree, supporting caching and optional multi-selection
  • Wizard - displays a multi-step process to be completed in a specific order

* Smart Dropdowns - _dropdown automatically decides whether it should be placed above or below the clicked element (can also force position). Add `data-direction="auto|up|down"` to element that has `data-toggle="dropdown"`_

• One-step installation and updates through volo
• AMD compatibility for modular structure and deployment optimization
• Grunt-based build script to easily create custom distribution files
• Namespaced CSS (just add a fuelux class) for safe use on existing sites

You can install FuelUX using volo. You will want to pass the -amdoff flag to volo to tell it not to try and amdify the project:

volo add -amdoff fuelux

• git clone git:https://github.com/ExactTarget/fuelux.git
• Default Fuel UX files for production use are located in the dist directory
• To customize, modify the JS and LESS files under src then run grunt to regenerate your dist directory (more below)

Hosted on GitHub pages: https://exacttarget.github.com/fuelux

Hosted on our Developer Community: https://code.exacttarget.com/devcenter/fuel-ux

Use GitHub issues: https://github.com/ExactTarget/fuelux/issues

Visit our UserVoice community: https://fuelux.uservoice.com

Fuel UX is semantically versioned: https://semver.org

• Fix disappearing borders in datagrid headers in IE on hover
• Fixing selection of wizard step content
• Fixing how one wizard's controls (prev, next) caused all other wizard's steps to slide

• Tree control fixed event when unselecting last item. Adds supports for decorating folders with markup. Adds updated event
• Wizard selectItem method now supports set current step
• Wizard horizontally scrolls when many steps are present
• Added many conveniece methods to Pillbox
• FuelUX updated to use GruntJS 0.4.x
• FuelUX Intelligent Dropdowns
• Tree control selectFolder method fixed and collapse method added
• Convenience methods added to radio and checkbox controls
• New option "noDataFoundHTML" added to datagrid control
• Select control fixed for leftover resizing element
• Datagrid control supports custom class on a column
• Fixed initial page size on datagrid

• Reset datagrid to first page on filter change
• Fix datagrid operation inside HTML form
• Fix datagrid header wrapping for narrow columns
• Improve datagrid class specificity for inner controls
• Fix datagrid race condition with next and previous buttons
• Improve datagrid fault tolerance around paging operations
• Improve sample datasource to handle null values when searching
• Fix select control value selection when value contains spaces
• Fix checkbox operation inside datagrid
• Fix checkbox operation inside form-inline
• Fix checkbox operation for IE8
• Fix tree text wrapping issue
• Fix spinner issue when passing a string as a value
• Fix button group operation inside wizard step
• Backport tooltip options fix from Bootstrap 3
• Upgrade Bootstrap from 2.3.0 to 2.3.2

• Add custom filter support to datagrid
• Use select control for datagrid page size dropdown
• Add stepclick event to wizard to support canceling clicks on steps
• Improve rounded corners of combobox button to match Bootstrap
• Improve support for installation within Yeoman
• Upgrade Bootstrap from 2.2.2 to 2.3.0

• Fix whitespace issue in wizard
• Improve encapsulation of AMD globals
• Introduce Testem for cross-browser testing
• Fix tree datasource reference for local development
• Upgrade unit tests to be compatible with jQuery 1.9

• New Control - checkbox
• New Control - radio
• New Control - select
• New Control - tree
• New Control - wizard
• Add stretchHeight option to datagrid
• Add reload method to datagrid
• Add enable and disable methods to search control
• Add enable and disable methods to combobox
• Add rich methods for getting/setting selected item to combobox
• Fix triggering of superfluous spinner events
• Upgrade Bootstrap from 2.2.1 to 2.2.2

• Allow setting spinner value to zero
• Fix search control keyboard operation in IE8

• Upgrade Bootstrap from 2.1.1 to 2.2.1

• Ignore click on disabled search button
• Make cursor consistent on disabled spinner buttons
• Improve live docs to show disabled states where available
• Complete datagrid unit test coverage

• Fix loader.js (used for non-AMD pages) to be synchronous

• First public release of Fuel UX

Before writing code, we suggest you search for issues or create a new one to confirm where your contribution fits into our roadmap.

In lieu of a formal style guide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using grunt.

More about Contributing to Fuel UX

Please don't edit files in the dist directory as they are generated via grunt. You'll find source code in the src directory!

While grunt can run the included unit tests via PhantomJS, this isn't a substitute for the real thing. Please be sure to test the test/*.html unit test file(s) in real browsers as well.

More about Installing grunt and PhantomJS

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.

We are grateful to the maintainers, contributors, and sponsors of the following technologies which make FuelUX possible:

• jQuery (Library for DOM, events, animation, and AJAX)

• Twitter Bootstrap (Modern UI components and interactions)

• LESS and recess (Stylesheet definition and management)

• RequireJS and volo (Tools for managing modular JavaScript)

• grunt (Build tool for JavaScript projects)

##Authors

Adam Alexander

• https://twitter.com/adamalex
• https://github.com/adamalex

Matt Beard

• https://github.com/mbeard

Bryan Kohlmeier

• https://github.com/bkohlmeier

Kevin Parkerson

• https://github.com/kevinparkerson

Christopher McCulloh

• https://github.com/cmcculloh

David Waltz

• https://github.com/dwaltz

Dustin McCormick

• https://twitter.com/djmccormick
• https://github.com/djmccormick

Alex Vernacchia

• https://twitter.com/vernacchia
• https://github.com/vernak2539

Scott Plumlee

• https://twitter.com/scottplumlee
• https://github.com/plumlee

Marvin Pribble

• https://github.com/marvinpribble

Ryan Moore

• https://github.com/rbmoore

Steven Rogers

• https://github.com/soldoutactivist

Copyright (c) 2012 ExactTarget

Licensed under the MIT License (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the COPYING file.

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.