Liking cljdoc? Tell your friends :D

Cljsjs is deprecated

The most common packages like React will continue to be maintained in Cljsjs. But there are better alternatives for using JS libraries.

Maintainers might still accept PRs but if you are just adding a library for use in your application, consider alternatives before creating a PR.

Why does Cljsjs exist

  • To allow easy use of JS libraries from Cljs -> No longer needed
  • To ensure there is only single copy of the JS library in classpath -> Still relevant, in some cases

Why isn't Cljsjs perfect

  • Centralized repository needs maintainers to review and merge PRs
  • Outdated tooling, open issues with tooling

Better solutions

Using a JS library from a application project

Use shadow-cljs or ClojureScript with Webpack to directly consume npm packages. You always get access to up-to-date versions.

Using a JS library from a Cljs library

Depending on your library, you could just require that the consumers of your library use shadow-cljs or webpack to provide requires JS libraries. If you need to ensure users can use the library with foreign-libraries, you could package the JS library yourself as a JAR, same as what cljsjs does, but you can do this yourself using Leiningen or clj.

Compared to Cljsjs, you need to create a bit of tooling yourself, but you are free to update the JS library yourself.

CLJSJS Packages

CLJSJS logo

CLJSJS is an effort to package Javascript libraries to be able to use them from within ClojureScript.

Using these packages

All packages provided by cljsjs provide deps.cljs files that will be automatically picked up by the ClojureScript compiler as of 0.0-2727. Versions of the Jar reflect the version of the packaged JS lib.

You can find the specific coordinates for those packages in their respective README files.

Documentation

The wiki of this repo is used for community maintained documentation:

If you'd like to contribute there's a small section on that as well.

For information and help

Clojurians slack (join) has a channel #cljsjs for talk about Cljsjs.

Can you improve this documentation? These fine people already did:
Martin Klepsch, Juho Teperi, J. Pablo Fernández, Léon Talbot & Matthias Nehlsen
Edit on GitHub

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close