This library is currently in an experimental phase. It should not be used in any kind of production system unless you feel ok about forking it and maintaining the fork. Once the ideas have stabilized then I may do an official release with stable documentation and APIs.

See the YouTube Video for a demonstration of a working prototype.

HELP WANTED: This project is more ambitious than my time will allow. If you have Clojure chops and are interested in helping, please let me know.

Here are the goals:

• Build applications quickly, without serious compromises:

  • Minimal Boilerplate

  • Easily (and gradually) escape to custom code when your needs outgrow the system’s abilities.

The facets that this library are intended to address:

• OPEN model (via namespaced keywords and maps)

  • All declarative constructs use open maps in CLJC so that library extensions can easily add capabilities.

• Declarative data model to facilitate:

  • Generated database schema (if desired) with migration management.

    • Database adapter makes it possible to use any database.

  • Generated demand-driven server APIs

  • Declarative (extensible) permissions model.

• Authentication

  • Extensible system for obtaining and managing client authentication.

  • Demand-driven authentication (login pops if a screen needs to work with data that requires auth)

• Forms

  • Declarative and extensible in all aspects: validation, rendering, permissions, etc.

  • Support for graph-based forms (nested forms with relations)

  • Automatic logic for complete data management Create/Update/Delete.

  • Integration with permissions (authorization)

  • Ability to generate UI with ability to incrementally override.

  • Pluggable UI generation system: Support web, native, etc., from a single declaration.

• Reports

  • Input parameters

  • Pretty much everything from "Forms", but for read-only display.

  • Completely generated output, with ability to incrementally override.

At the moment I recommend checking out the source of fulcro-rad-demo, fulcro-rad, fulcro-rad-datomic (or sql) and adding the following to your global (i.e. ~/clojure) deps.edn file:

so that you can work on all of the libraries at once.

Starting the CLJS build is then:

and then add the above projects as modules (if using Cursive).

This will let you edit files in all of the relevate projects at the same time. See development.clj, where you may have to update the set-refresh-dirs to make sure CLJ source is updated when you restart the server.

Use the same deps aliases in your CLJ REPL in addition to -A:datomic or -A:sql, and load the development namespace (in the respective source folder for either sql or datomic). The server start/restart functions are in there.

You will, of course, have to have Datomic installed with a transactor running to use the Datomic back-end.

More About Setup (Emacs centric)

gem install foreman

Startup

foreman start Procfile.dev

user=> (dev)

development=> (go)

development=> (reset)