Webly

• This project is used in Notebook and Goldly.
• Tools to build reagent/re-frame clojurescript web apps that are served from a clojure webserver.
• End Users this project is not for you.

UI demo

lein webly npm-install
lein prep-res
lein webly watch     ; The demo runs a webserver on port 8000. "shadow-cljs watch" mode

lein webly compile  ; Build cljs bundle, and output bundle stats
lein webly jetty     ; Serves website from precompiled bundle.

lein webly release   ; Build cljs bundle, and output bundle stats. no tenx. no source-maps
lein webly jetty     ; Serves website from precompiled bundle.

lein test-clj        ; Run unit tests - clj
lein test-js         ; Run unit tests - js

Demonstrates

• loading animation
• navigation links to registered handlers (and error for unregistered handler)
• notifications
• dialog
• api endpoints
• oauth2

Features

webly build

• this feature is available for apps that use webly
• compiles/watches via shadow-cljs
• does not require shadow-cljs.edn
• bundle-size report at compile time

web app

• dynamically generated app html that works with csrf
• ring middleware for api calls
• routing with bidi (this allows to have links within the web-app)
• this means a registry for ring-handlers and reagent-views
• oauth2 with github

Bidi Routing

Bidi is not as highly starred as compojure, but it has important benefits:

• It is isomorphic (clj and cljs) (forget compojure AND secretary)
• It has a clear separation of concerns with handlers (both for clj (ring-handler) and cljs (pushy)
• It is bi-directional; this allows making links!
• It does not use macros, this means routes can be easily tested, transformed, sent between client-server, stored, modified.
• No linting errors due to macros.
• Easy testing of route definitions, and handler results (including wrapping routes)