Contributing to Famo.us

Active involvement from the community is essential to making Famo.us the most capable and performant front-end JavaScript platform out there. You can help by reporting bugs, fixing bugs, adding features, contributing new modules, and providing feedback.

Reporting bugs and other issues

Famo.us is a platform that is always testing the limits of where browsers can go. As a result, it’s likely that you may encounter bugs or other issues while developing with it. If you think you’ve encountered a bug, do the following:

Make sure you are working with the latest version of the Famo.us develop branch.
Browse through the issues to check if anyone else has already reported the issue you’re seeing. If someone has, feel free to add more information to that issue.
If no one has yet submitted the issue you are encountering, be sure to include as much information as possible, including errors, warnings, screenshots, or videos that help us reproduce the issue.

Contributing code

The Famo.us platform is made possible by contributors like you. We’re very interested in getting help from the greater community, but before you start, it’s important that you become acquainted with our workflow. Following these guidelines below will make collaboration much smoother and increase the chances that we will accept your pull request without hiccups.

Development process

Our development process is very similar to the approach described in the well-known article A Successful Git Branching Model. Here’s an overview:

Our develop branch is the branch upon which all Famo.us developers should be basing their work on. (The develop branch is not guaranteed to be stable.)
All commits intended for develop should take place on your own personal fork, and be submitted via pull request, when ready, to the develop branch.
Only maintainers can accept pull requests from forks into the core Famo.us repository.
Please squash your commits into a single commit before making a pull request.

Getting started

Make sure you have a GitHub account
Fork famous
Keep your fork up to date. Famo.us is a fast-moving project, and things are changing all the time. It’s important that any changes you make are based on the most recent version of Famo.us, since it’s possible that something may have changed that breaks your pull request or invalidates its need.
Make sure you have a Contributor License Agreement on file.

Contributor License Agreement

Before we can accept any contributions to Famo.us, we first require that all individuals or companies agree to our Contributor License Agreement (CLA). The e-mail address used in the pull request will be used to check if a CLA has already been filed, so be sure to list all email addresses that you might use to submit your pull requests when filling it out. Our CLA can be found here.

Testing and linting

Travis-CI is integrated into all of our modules to automatically run tests on our codebase. All pull requests must pass our tests before they can be merged. Currently, the only test we support is a linting test. This ensures a consistently styled codebase. Before making a pull request, please run our linter locally.

Bug fixes

If you’d like to contribute a fix for a bug, first read up on how to report a bug and report it so we are aware of the issue. By filing the issue first, we may be able to provide you with some insight that guides you in the right direction.

Next: Core Famo.us »