sezaljain / boodle

Accounting SPA in Clojure and ClojureScript

boodle

Simple accounting SPA in Clojure and ClojureScript.

boodle uses these Clojure/ClojureScript libraries:

• aero

• bidi

• compojure

• hikari-cp

• honeysql

• http-kit

• next.jdbc

• re-frame

• ring

• tongue

I used Bulma for the UI, and I customised re-frame-modal and cljs-pikaday to play well with it. Check the documentation for more details.

Usage

Prerequisites

To run boodle, you need:

• a Java JDK/JRE suitable for your system (I use OpenJDK)

• Clojure

• PostgreSQL

• yarn

• gulp

• shadow-cljs

Database setup

Set up the database with the necessary tables and permissions you find in model.sql. Check also resources/config/config.edn to adjust the database connection parameters.

Compiling

From the project root, run:

$ yarn
$ cd resources/src
$ gulp

Compile the ClojureScript files with:

$ shadow-cljs compile boodle

Running

From the project root, fire up the server with:

$ clj -A:run

You can now browse at http://localhost:8080 and interact with boodle.

Docker and Docker Compose

Thanks to Moritz Marquardt, you can also run boodle via Docker and Docker Compose:

$ git clone https://github.com/manuel-uberti/boodle.git && cd boodle
$ docker-compose up -d

You can now access boodle at http://localhost:8080.

Tests

Unit tests are configured with kaocha and can be run from the project root with:

$ ./bin/kaocha

Extra

The included etc/boodle.service is a basic systemd unit that executes etc/deploy.sh to update, build and run boodle automatically on my home server.

License

Copyright © (iterate inc 2017) Manuel Uberti

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