Fine Uploader is:
- 100% Free Open Source Software
Fine Uploader and all other projects in this organization thrive thanks to donations by Widen (the project’s sponsor) and support by developers in the community. If you’d like to help and keep this project strong and relevant, you have several options.
File a bug report
If you see something that isn’t quite right, whether it be in the code, or on the docs site, or even on FineUploader.com (which is hosted on GitHub), please file a bug report. Be sure to make sure the bug hasn’t already been filed by someone else. If it has, feel free to upvote the issue and/or add your comments.
Join the team
Help spread the word
Are you using Fine Uploader in your library or project? If so, let us know and we may add a link to your project or application and your logo to FineUploader.com. If you care to write an article about Fine Uploader, we would be open to reading and publicizing it through our site, blog, or Twitter feed.
Develop an integration library
Are you using Fine Uploader inside of a larger framework (such as React, Angular2, Ember.js, etc)? If so, perhaps you’ve already written a library that wraps Fine Uploader and makes it simple to use Fine Uploader in this context. Let us know and it may make sense to either link to your library, or even move it into the FineUploader GitHub organization (with your approval, of course). We’d also love to see libraries that make it simple to pair Fine Uploader with other useful libraries, such as image editors and rich text editors.
The best way to contribute code is to open up a pull request that addresses one of the open feature requests or bugs. In order to get started developing Fine Uploader, read this entire section to get the project up and running on your local development machine. This section describes how you can build and test Fine Uploader locally. You may use these instructions to build a copy for yourself, or to contribute changes back to the library.
You must have Node.js instaled locally (any version should be fine), and you must have Unix-like environment to work with. Linux, FreeBSD/OS X, Cygwin, and Windows 10 bash all should be acceptable environments. Please open up a new issue if you have trouble building. The build process is centered around a single Makefile, so GNU Make is required as well (though most if not all Unix-like OSes should already have this installed). Finally, you will need a git client.
To pull down the project & build dependencies:
- Download the project repository:
git clone https://github.com/FineUploader/fine-uploader.git.
- Install all project development dependencies:
Generating build artifacts
- To build all build artifacts for all endpoint types:
make build. You can speed this process up a bit by using the parallel recipes feature of Make:
make build -j. If you would like to build only a specific endpoint type, see the Makefile for the appropriate recipe. The build output will be created in the
- To build zip files for all endpoint types:
make zip. To build a zip for only a specific endpoint type, see the Makefile for the appropriate recipe. The zip files will be included alongside the build output in the
- To rev the version number:
make rev-version target=NEW_VERSION, where
NEW_VERSIONis the semver-compatible target version identifier.
To build, run the tests & linter:
npm test (you’ll need Firefox installed locally).
Commiting new code and changes
Fine Uploader is a code library sponsored by Widen Enterprises, Inc.