Git Product home page Git Product logo

cdnjs's Introduction

Build Status Dependency Status devDependency Status

cdnjs Library Repository

cdnjs is the repository mirroring all library assets on

Thomas Davis and Ryan Kirkman created cdnjs, Drew Freyling and Peter Dave Hello are maintainers. Juan Gallardo is our community moderator.

cdnjs will host any production version of any JavaScript/CSS library, subject to licence permissions.

  • Beta, release candidate and alpha releases are not usually considered ready for full production status. Requests for pre-release versions of libraries may be declined after peer review.

Please raise a new pull request for new library additions and existing library updates, following the instructions below.

Adding a new or updating an existing library

cdnjs relies on user-submitted pull requests and automatic updating via npm to populate and update libraries.

To add a new library, or update an existing library outside of npm, start by forking the cdnjs repo to your own GitHub account.

If you're adding/modifying outside of the GitHub browser interface, for example on the command line or with the GitHub desktop application, you will need to additionally install node locally. For more information on installing node, please refer to

When you have forked the cdnjs repo, add your library to it. Libraries are stored in the ajax/libs directory. Each library has its own subdirectory of ajax/libs and each version of the library has its own subdirectory of the library directory name, for example:



You should consider the following when adding to or updating the library, so that we can keep our project neat, clean and clear:

  • Filenames should not include a version number and be lowercase.

    • This is OK: useful.min.js, but this is not: useful-2.0.1.min.js.
  • JavaScript & CSS files should be minified to reduce network traffic and browser overhead.

    • If the library doesn't already provide a minified version, cdnjs's preferred JavaScript minifier is UglifyJS
  • If you are updating a library, please try to maintain consistency with the existing file and directory structure.

    • There will be occasions, particularly with major version increments, where this is not practical.
  • You should sync your local repositry with our master branch as new as possible, try to make the commits' parent be new.

  • Please use git pull --rebase instead of git pull, use git rebase upstream/master instead of git merge upstream/master, so that we can avoid of meaningless merging.

  • Only do one thing in one commits, don't mix different things into the same commit.

  • Every commits should be meaningful, don't cut one thing into multiple commits.

  • Inspect your work by git diff & git status before commit your change.

  • Inspect your commit by git log --stat & git log -p before sending a pull request.

Create or update package.json

Each library has a corresponding package.json, written in npm format (see test/schemata/npm-package.json for details or use another package.json to crib from - it's pretty self-explanatory). When an existing library is updated, the details in package.json should be updated where required.

For example, if a new version of the library is added, the version number may need changing. Likewise, if you're adding npm update information to a library, this is done in package.json.

Install npm test dependencies

If you don't have vows installed do so by running:

npm install -g vows

Run npm test to check all is well

If you're updating the library outside of npm or the GitHub browser, you should run npm test from the library directory to ensure everything is OK.

If you run npm test and see no errors, all is well; resolve any errors before you raise your pull request and re-run npm test to ensure everything works.

If you see an error then run npm install before running `npm test:

vows: command not found
npm ERR! Test failed.  See above for more details.
npm ERR! not ok code 0

Pull request pre-flight checks

  • Have you comply with our conventions?
  • Have you followed the library directory structure?
  • Does a valid and accurate package.json exist for the library?
  • Have you minified JavaScript and CSS?
  • Did npm test check out OK?

...if so, great! You're ready to raise a pull request.

Raising a pull request

Please restrict your pull request to one library. You can include >1 version/release of a library in a single pull request.

From a maintenance standpoint, it's much more straightforward to process pull requests where there is one commit for one library.

In your pull request title, tell us what you're doing. If you are the author of the library, please add [author] to the pull request title.

Please include the following in your pull request:

  • The origin of your new files
    • e.g., where you downloaded the version from

A URL is ideal. Providing the origin of your files is very helpful as the cdnjs project is peer-reviewed. Practically speaking, it also helps us process your pull request more efficiently, which means your files go live sooner. Help us and we'll help you back.

Enabling npm auto update

We are currently in the process of converting as many libraries to NPM auto update as possible. For a bit of fun, cdnjs will send you $5 USD in Bitcoin for each library you convert to NPM auto-update. If you could tag your pull request with [BC] and throw your Bitcoin address in the commit, we will send your payment through as soon as possible. If you would like to keep your BC address private, send an email to [email protected] with the details.

cdnjs automatically updates libraries that are known to be hosted on npm e.g., Lodash. This auto-update script runs every 15 minutes.

To add an npm hook to a library, update the package.json with configuration details and submit your pull request. An example configuration:

  "npmName": "lodash",
  "npmFileMap": [{
    "basePath": "/dist/",
    "files": [
  • npmName should map to the name of the library on npm
  • npmFileMap is a list of files to take from the npm tarball and host on cdnjs
  • basePath will be ignored when copying over to the CDN
  • files is a pattern matcher allowing selection of multiple files

The above example looks in the tarball whose structure might look like this:

| |__lodash.compat.js
| |__lodash.compat.min.js
| |__lodash.js
| |__lodash.min.js
| |__lodash.underscore.js
| |__lodash.underscore.min.js

The auto-update process will look for dist inside the named tarball and copy all the JavaScript file to cdnjs, minus the dist path. The resulting files in cdnjs will be:


...where x.y.z is the version number, extracted from the package.json on npm.


You can search cdnjs via our API:

Without any query parameters it will return the name and main file URL of every library on cdnjs. To search, use:

If you would like more data, use the fields parameter which takes comma-separated values:,description

To get a list of all files for that library, use the assets field:

Other fields available are:


The API is served over Cloudflare with a six-hour expiry for requests.

Extensions, Plugins, Resources

Extensions, Plugins, Resources


The bot account is called the-cdnjs-curator

cdnjs's People


agourlay avatar alfredwassermann avatar bayandin avatar codler avatar drewfreyling avatar eryx avatar gavinhungry avatar gfranko avatar haferje avatar hebbet avatar jackdoyle avatar jdalton avatar jgallardo avatar josdejong avatar juliusrickert avatar koggdal avatar kzeni avatar leonardehrenfried avatar lockyc avatar mattpodwysocki avatar meltingice avatar mkoryak avatar peterdavehello avatar pwnall avatar rwjblue avatar ryankirkman avatar terrymun avatar thomasdavis avatar wyuenho avatar xrmx avatar


 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.