How do I set up shadow-cljs for a React Native project?

Use the :react-native build target in shadow-cljs.edn, and follow the quick start to configure modules and dependencies; examples in the README show React Native integrations. Ensure you have Node.js and Java installed as per requirements.

shadow-cljs vs Leiningen for ClojureScript development?

shadow-cljs excels with npm integration and modern tooling, offering simpler configuration and live reload out of the box, while Leiningen is better for pure Clojure projects or teams avoiding npm. The choice depends on your dependency management needs.

Can I use shadow-cljs without installing npm?

No, the README lists npm, bun, pnpm, or yarn as requirements for managing JavaScript dependencies; shadow-cljs is designed around seamless npm integration, so alternatives like pure Clojure tools won't work.

How to debug ClojureScript code with shadow-cljs?

Utilize the CLJS REPL for interactive debugging and the built-in development server with live reload; the README mentions REPL support for browser and Node.js targets, and external guides provide additional tips.

Does shadow-cljs support server-side rendering?

Yes, via the :node-script or :browser targets with appropriate configurations, but it requires JavaScript runtime setup; the README doesn't explicitly detail SSR, so you might need to consult community examples.

How to deploy a shadow-cljs app to production?

Configure builds with optimizations like code splitting via :modules, and output static assets; the README covers basic build setup, but for deployment, refer to the User's Guide or external resources for best practices.

Open-Awesome

shadow-cljs

EPL-1.0Clojure

A comprehensive build tool and development environment for ClojureScript with seamless npm integration.

Visit Website GitHub

2.4k stars187 forks0 contributors

What is shadow-cljs?

shadow-cljs is a build tool and development environment for ClojureScript that simplifies compilation and integrates seamlessly with npm. It provides fast builds, live reload, REPL support, and targets multiple platforms like browsers, Node.js, and React Native, solving the complexity of setting up ClojureScript projects.

Target Audience

ClojureScript developers who want a streamlined build process with modern JavaScript tooling, especially those working on web applications, Node.js scripts, or React Native projects.

Value Proposition

Developers choose shadow-cljs for its ease of use, excellent npm integration, and comprehensive feature set out of the box, reducing configuration overhead compared to other ClojureScript build tools.

Overview

ClojureScript compilation made easy

Use Cases

Best For

Building ClojureScript web applications with hot-reload
Developing Node.js scripts or CLI tools with ClojureScript
Creating React Native apps using ClojureScript
Integrating npm packages into ClojureScript projects seamlessly
Setting up a ClojureScript development environment quickly
Optimizing ClojureScript builds with code splitting

Not Ideal For

Projects using pure JavaScript or TypeScript without ClojureScript
Teams heavily invested in traditional Clojure tooling like Leiningen or tools.deps for all build aspects
Simple one-off scripts where a full build tool setup is overkill

Pros & Cons

Pros

Seamless npm Integration

Directly use npm packages and manage JavaScript dependencies without complex bridging, as highlighted in the README's features.

Versatile Build Targets

Supports :browser, :node-script, :npm-module, :react-native, and more out of the box, simplifying multi-platform development.

Developer Experience Focus

Includes live reload for CLJS and CSS, a CLJS REPL, and a built-in development server, making development smoother and more interactive.

Fast Incremental Compilation

Reliable caching ensures quick rebuilds during development, reducing wait times as mentioned in the features list.

Cons

Java Runtime Dependency

Requires Java SDK 21+ as per the requirements, adding an extra setup step and potential compatibility issues compared to pure Node.js tools.

Incomplete Documentation

The User's Guide is noted as a work in progress in the README, which can make learning and troubleshooting more challenging for new users.

npm-centric Ecosystem

While excellent for npm integration, it may not align well with teams preferring Clojure-specific dependency management without JavaScript tooling.

Frequently Asked Questions

Related Projects

Leiningen

Moved to Codeberg; this is a temporary convenience mirror

Stars7,307

Forks1,580

Last commit7 months ago

lein-figwheel

Figwheel builds your ClojureScript code and hot loads it into the browser as you are coding!

Stars2,874

Forks205

Last commit2 years ago

Lumo

Fast, cross-platform, standalone ClojureScript environment

Stars1,875

Forks83

Last commit3 years ago

Boot

Build tooling for Clojure.

Stars1,748

Forks178

Last commit5 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub