views.reagent/examples/class-registry

views.reagent Example - Class Registry

This is a "Class Registry" application that has a lot of CRUD operations in it which allow users to manage students and professors, as well as classes and then assign the students/professors to those classes. The idea is very loosely based off one of the Om tutorial applications (the data used is almost identical).

Note that this example is somewhat complicated as there are several lists of data shown in the UI, all of which are completely editable to the user. While the code is longer as a result, this still serves as a more interesting example with several views being used (some using parameters).

Definitely take a look at the Todo MVC example app before diving into this and also be sure you're familiar with Reagent.

Running

Creating the Database

This example app uses a PostgreSQL database. The SQL script to create it is in create_db.sql.

A Docker compose file pgsql.docker-compose.yml is provided and pre-configured to allow you to quickly spin up a PostgreSQL database that will be pre-initialized via create_db.sql through Docker.

$ docker-compose -f pgsql.docker-compose.yml up

Alternatively, if you already have a PostgreSQL database available, you can run the create_db.sql via psql easily enough:

$ psql < create_db.sql

(Of course, add any username/host parameters you might need)

Starting It Up

To build everything and run in one step:

$ lein rundemo

Then open up a web browser or two and head to http://localhost:8080/ to see the web app in action.

If you want to run this application in a REPL, just be sure to build the ClojureScript:

$ lein cljsbuild once

And then in the REPL you can just run:

(-main)

to start the web app (you should be put in the correct namespace immediately).