loading...

ClojureScript Loves NPM

jacekschae profile image Jacek Schæ Updated on ・3 min read

Alt Clojure Script Loves React

Every languge that complies/transpiles to JS want to connect to npm to use this huge ecosystem. The master of this is of course Ecma Script. The second one - in my humble opition - is ClojureScript, due to shadow-cljs.

Disclaimer: I know there is a lot of work going on in differnt communities that tap into npm. By all means I don't try to diminish any of that and state that CLJS (ClojureScript) is the best . I want to give you a glance how this works in ClojureScript.

Installing npm packages

In ClojureScript we would install npm packages as we would in JavaScript. We would use standard package.json and shadow-cljs build tool would figure out the rest.

Alt npm install

After the installation we would have to require the package. The require statment is almost identical to import from JS. In CLJS we swap the order - first we say from where and then what.

Alt import firebase

Every ClojureScript file starts with a ns - namespace declaration. Following that we have require, instead of import . And then we are defining a function with defn . This function will tap into our required firebase packages and instead of using . to navigate to our method initializeApp we are using / . We make sure that when we invoke JS method initializeApp we are converting CLJS map (datastructure) to JS Object with #js.

Let's try some other npm packages to get a better feeling for interop between npm and ClojureScript.

React

How about using React? ClojureScript has a couple of wrappers for React - the most popular one is Reagent. Here is a simple counter example with React hooks and Reagent.

Alt react-reagent

In both examples we are first importing/requiring React and Reagent. Then we are defining state in React - using hooks and in Reagent using atoms.What follows is JSX (JavaScript) and hiccup (ClojureScript) component. This is cool, but how would we use React UI Libraries from Reagent?

React UI Libraries

One of the most popular UI libraires is material-ui. After the installation we require this library and then import our Button component as well as React. In Clojure Script we only require the Button. We don't need to require Reagent since it's in our ClojureScript deps. To interop with React we would use :> form and pass all of the properties that we want in a {}.

Alt material-ui-button

Redux

How about Redux you ask? Well, there is a library that is build on top of Reagent, called re-frame. First designed in Dec 2014, it even pre-dates the official Elm Architecture.

Alt redux-re-frame

By now you should have a pretty good picture why CLJS loves npm ecosystem and how easy it is to interop from CLJS to JS. Maybe this is interesting for you, and your are wondering why? Why should you even try ClojureScript?

Why?

Immutable

All ClojureScritp data structures are immutable and presistant. You don't need to learn new API if you want to leaverge something like ImmutableJS.

Functional

ClojureScript embraces Functional Programming ideas at its core. You don't need Lodash or Ramda.

Simple

With shadow-cljs you don't need to spend time configuring your builds. You require what you need and the build tool will do the job.

Concise

You liability is the LoC you write . ClojureScript is one of the most concies programming languges out there. Chek out the last section of this comparision.

Powerful

ClojureScript uses Google Closure Tools for code minification and tree shaking. The same tolls that Google is using to build Gmail, Google Calendar, Google Docs, Google Maps.

JavaScript

It compiles/transpiles to JavaScript. Just as ES (EcmaScript) ReasonML,PureScript, and Elm.

Friendly

ClojureScript community is the most friendly and welcoming group of people that I have ever met online. We mainly hang out on Slack and ClojureVerse.

Full-Stack

ClojureScript older brother - Clojure embraces all of these ideas with Java. If you want to write your server on one of the most performant and stable platform there is - Java Virtuel Machine - you can do that using the same language.

If you like this article you should follow me on Twitter. I only write/tweet about programming and technology - mainly about ClojureScript and Clojure.

Posted on by:

Discussion

markdown guide
 

The "if npm fails, use yarn" command was racist against pnpm :v
I suggest changing it to:

pnpm i -S firebase || yarn add firebase || npm i -S firebase

:v

 

What is the secret sauce here (in shadow-cljs)? I tried all your examples and I could not get any of them to work.

 

No secret sauce :). Take a look at the learnreagent.com free course. Everythink is pretty easily explained and accessible. If this doesn't help please let me know.

 

There is a Free and a Pro version - the free part goes over the setup with shadow-cljs.