Awesome
Om
NOTE: This project is no longer under active development. If you'd like to use a library that's well maintained that was inspired by some of the ideas presented here see Fulcro
A ClojureScript UI framework and client/server architecture over Facebook's React.
Om UIs are out of the box snapshotable and undoable and these operations have no implementation complexity and little overhead.
Om borrows ideas liberally from Facebook's Relay and Netflix's Falcor with a dash of inspiration from Datomic pull syntax to avoid the typical incidental complexity that arises from client/server state management.
Dependency Information
Latest release: 1.0.0-beta1
Leiningen and Boot dependency information:
[org.omcljs/om "1.0.0-beta1"]
Maven dependency information:
<dependency>
<groupId>org.omcljs</groupId>
<artifactId>om</artifactId>
<version>1.0.0-beta1</version>
</dependency>
Example
(ns example
(:require [goog.dom :as gdom]
[om.dom :as dom]
[om.next :as om :refer [defui]]))
(defui Hello
Object
(render [this]
(dom/h1 nil "Hello, world!")))
(def hello (om/factory Hello))
(.render js/ReactDOM (hello) (gdom/getElement "example"))
Tutorials
There is an Quick Start tutorial that will introduce you to the core concepts of Om here. There are also a variety of other guides here.
Documentation
There is documentation here
Contributing
Please contact me via email to request an electronic Contributor Agreement. Once your electronic CA has been signed and returned to me I will accept pull requests.
Community
If you are looking for help please get in touch either on the clojurians.slack.com #om channel or the om-cljs Google Group.
References
- Worlds: Controlling the Scope of Side Effects
- A Functional I/O System
- Directness and Liveness in the Morphic User Interface Construction Environment
- Learnable Programming
- Relay
- Falcor
- GraphQL
- Datomic pull syntax
Copyright and license
Copyright © 2013-2017 David Nolen
Licensed under the EPL (see the file epl.html).