<img src="http://fineuploader.smartimage.com/pimg/a8680d51" width="300">
Documentation | Examples | Support | Blog | Changelog
Fine Uploader is:
- 100% Free Open Source Software
ContributingIf you'd like to help and keep this project strong and relevant, you have several options.
Help us pay the billsFine Uploader is currently looking for a sponsor to pay the AWS bills (which have recently lapsed). These add up to about $40/month. Please open an issue if you are interesting in becoming a sponsor. We will happily list you as sponsor on the site and README.
File a bug reportIf 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 filedissues by someone else. If it has, feel free to upvote the issue and/or add your comments.
Help spread the wordAre 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 libraryAre 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.
Contribute codeThe best way to contribute code is to open up a pull request that addresses one of the open feature requests or bugsissues. 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.
SetupYou 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.
Running testsTo build, run the tests & linter:
npm test (you'll need Firefox installed locally).