KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

agua

★ 35 Open GitHub ↗

Utilities for writing simple webapps

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# agua

Simple, *isomorphic* Clojure webapps in a single
[Boot](http://boot-clj.com) file.

[](dependency)
```clojure
[pandeiro/agua "0.2.3"] ;; latest release
```
[](/dependency)

**Note: agua requires Java 8**

## What the hell is this?

Aside from some people's worst
[nightmare](https://twitter.com/alandipert/status/564940013805514752),
agua is a tool that lets you write and run a
[ClojureScript](https://github.com/clojure/clojurescript) app both **in
the browser** and **pre-rendered on the server**.

That means it lets you do something like this:

```clj
#!/usr/bin/env boot

(set-env!
 :dependencies '[[pandeiro/agua "0.2.3"]
                 [reagent       "0.5.0-alpha"]])

(require
 '[agua.core    :refer [defhtml defcss defcljs serve]]
 '[garden.color :refer [rgb]]
 '[garden.units :refer [px]])

(defhtml page
  [:head
   [:meta {:charset "utf-8"}]
   [:title "My App"]
   [:style "%s"]]            ; <- styles inserted
  [:body
   [:div#root "%s"]          ; <- pre-rendered view inserted
   [:footer "copyright you"]
   [:script "%s"]])          ; <- compiled raw js inserted

(defcss styles
  [:*
   {:box-sizing    :border-box}]
  [:body
   {:padding       (px 36)
    :background    :black
    :color         :lightgray
    :text-align    :center}]
  [:h1
   {:color         :white}]
  [:input
   {:font-size     (px 24)
    :background    (rgb 40 40 40)
    :border        "solid 1px white"
    :font-style    :italic
    :padding       (px 12)
    :color         (rgb 150 150 150)
    :border-radius (px 8)}]
  [:footer
   {:position      :fixed
    :bottom        0
    :left          0
    :padding       (px 24)
    :width         "100%"
    :font-family   :monospace}])

(defcljs app
  (ns app.core
    (:require [reagent.core :as r]))

(def state
    (r/atom
     {:person "person"}))

(defn- person-val [e]
    (or (not-empty (.-value (.-target e))) "person"))

(defn main [state]
    [:div
     [:h1
      (str "Hello, " (:person @state))]
     (when js/document
       [:input
        {:placeholder "Name, please"
         :on-change #(swap! state assoc :person (person-val %))}])])

(defn not-found []
    [:div
     [:h1
      (str "404: '" js/location.pathname "' wasn't found.")]])

(defn router []
    (condp re-find js/location.pathname
      #"^/$" [main state]
      [not-found]))

(if js/document
    (r/render [router] (.getElementById js/document "root"))
    (r/render-to-string [router])))

;; Server
;;
(defn -main [& args]
  (serve {:html page, :css styles, :app app}))
```

That script is included in
[this repo](https://github.com/pandeiro/agua/tree/master/example). To
run it, just do `./example/app.boot`. Then open the link in your
favorite browser (like [Lynx](http://lynx.isc.org/) or
[*eww*](http://www.gnu.org/software/emacs/manual/html_mono/eww.html) or
even [Chromium](http://www.chromium.org/Home)).

## Usage

To use agua, just bring along your favorite
[React](http://facebook.github.io/react/) wrapper (React is already
included and pre-rendering it server-side in Nashorn is already
configured) and write a script like the one above specifying your HTML
as a Hiccup vector, your CSS as Garden data structures, and your
ClojureScript application inline, as shown.

CSS is optional: if you include it, make sure your HTML template has
three '%s' placeholders, the first of which will hold the CSS. You can
then omit/include the `:css` key to `(serve ...)` accordingly.

## Help others

If you write something with this and would like to share, add it to
`example/` and submit a Pull Request!

## License

Distributed under the Eclipse Public License either version 1.0 or (at
your option) any later version.

agua

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README