About Footwork

Footwork is a frontend javascript framework based on KnockoutJS that aims to be fully featured, expressive, and easy to use while remaining as idiomatic and compatible with Knockout and its existing code base as possible.

It has features such as:

Custom elements/components and declarative view models
Automatic resolution and binding of declarative resources
Page routing with unlimited outlet support
Transition effect and animation system including sequenced animations
Does not require a build system or module loader (but it works great with them)
Inter-module communication and state sharing
Much, much more...

http://footworkjs.com/

Ready? Jump into the Getting Started section!

Build information¶

This verision of Footwork () was created with:

KnockoutJS
Lodash (custom build)

Issues¶

Please keep the issue tracker limited to bug reports, feature requests and pull requests. If you are reporting a bug make sure to include information about which browser and operating system you are using as well as the necessary steps to reproduce the issue.

If applicable, providing an example using services like JSFiddle, JSBin, or Tinkerbin (etc) would help a lot as well.

Contributing¶

Contributions are encouraged, please feel free to fork the repository and begin making changes.

General Flow¶

Fork the repo on GitHub
Clone the project to your own machine
Commit changes to your own branch
Push your work back up to your fork
Submit a Pull request to the dev branch so that your changes can be reviewed

Submission Notes¶

Please continue the coding style expressed in the rest of source.
If creating a new feature, please also add the corresponding test(s) for it.
In your pull-request, please do not include an updated dist/ build (generated via gulp dist), that is a final step done prior to release.

Website and Documentation¶

Contributions towards the website and/or documentation are also encouraged. There are companion repositories for both of these, please contribute to them directly:

Website (http://footworkjs.com)

https://github.com/footworkjs/footwork-website
Documentation (http://docs.footworkjs.com)

https://github.com/footworkjs/footwork-documentation

Building From Source¶

Clone the repo from GitHub:

git clone https://github.com/footworkjs/footwork.git
cd footwork

Install Node.js and NPM (if needed):

This is platform specific. Your OS may already include it, however if not please see: Installing Node.
Install gulp globally (if needed):
```
sudo npm install -g gulp-cli
```
Acquire build dependencies:
```
npm install
```
Run a gulp task to build/test/etc:
- Build everything (output in /build):
```
gulp
```
- You can include the ---debug option on any of the build/testing tasks to include/generate a source map in the output:
```
gulp --debug
```
- Build everything and run tests (coverage report output in build/coverage-reports):
```
gulp tests
```
- Watch for changes in the source code and automatically rebuild:
```
gulp watch
```
- Watch for changes in the source code/tests and automatically rebuild + run tests:
```
gulp watch-test
```
- Build everything, minify, and deploy to /dist (for release):
```
gulp dist
```
- To debug the tests in your own browser:
  - Make sure your build is made without being instrumented for test coverage by running the default build task (otherwise debugging might be a bit difficult):
```
gulp
```
  - Install karma (if needed)
```
sudo npm install -g karma-cli
```
  - Start karma and then you can access/debug the tests from your browser at: http://localhost:9876/debug.html
```
karma start
```

License¶

MIT license - http://www.opensource.org/licenses/mit-license.php