status-im/re-frame
2
0
Fork 0
mirror of https://github.com/status-im/re-frame.git synced 2025-02-23 15:28:09 +00:00
Code Issues Projects Releases Wiki Activity

Tweaks to the readme

Browse Source
This commit is contained in:
mike-thompson-day8 2015-05-03 01:41:16 +10:00
parent 25ed816603
commit 70987e5318
1 changed files with 55 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
README.md
View File

@ -1,4 +1,4 @@
# re-frame: Derived Values, Flowing [![Build Status](https://travis-ci.org/Day8/re-frame.png?branch=master)](https://travis-ci.org/Day8/re-frame)
# re-frame: Derived Values, Flowing
> This, milord, is my family's axe. We have owned it for almost nine hundred years, see. Of course,
@ -27,6 +27,8 @@ re-frame is a pattern for writing [SPAs] in ClojureScript, using [Reagent].
This repo contains both a **description of this pattern** and a **reference implementation**.
To quote McCoy: "It's MVC, Jim, but not as we know it".
To build a re-frame app, you:
- design your app's data structure (data layer)
- write and register subscription functions (query layer)
@ -55,12 +57,17 @@ Features:
and a hilarious, insiders-joke T-shirt, ideal for conferences (in design).
What could possibly go wrong?
__Warning__: this is a long document. That was the summary. The rest is a tutorial.
## Using It
[![Build Status](https://travis-ci.org/Day8/re-frame.png?branch=master)](https://travis-ci.org/Day8/re-frame)
[![Clojars Project](http://clojars.org/re-frame/latest-version.svg)](http://clojars.org/re-frame)
__Warning__: okay, that was the summary. What follows is a lengthy tutorial with a [Where Do I Go Next](#Where-Do-I-Go-Next) section at the end.
## Table of Contents
## Tutorial Table of Contents
*generated by [DocToc](https://github.com/thlorenz/doctoc)*
- [What Problem Does It Solve?](#what-problem-does-it-solve)
- [Correct Acronym?](#correct-acronym)
@ -95,6 +102,7 @@ __Warning__: this is a long document. That was the summary. The rest is a tutor
- [Talking To A Server](#talking-to-a-server)
- [The CPU Hog Problem](#the-cpu-hog-problem)
- [In Summary](#in-summary)
- [Where Do I Go Next](#Where-Do-I-Go-Next)
- [Licence](#licence)
## What Problem Does It Solve?
@ -129,7 +137,7 @@ but not as we know it".
In re-frame, none of the M, V, or C bits are objects, they
are pure functions (or pure data),
and they are all wired together via reactive data flows. It is sufficiently different in nature
from (traditional, Smalltalk) MVC that calling it MVC would likely just be confusing. I'd
from (traditional, Smalltalk) MVC that calling it MVC would likely just be confusing. So, I'd
love an alternative.
Perhaps it is a RACES framework - Reactive-Atom Component Event
@ -146,13 +154,13 @@ insider's joke, conference T-Shirt.
Not much about re-frame is original or clever. You'll find
no ingenious use of functional zippers, transducers or core.async.
Re-frame does use Reagent's features in a slightly novel way.
And I did actively reject the current ClojureScript fashion of using Cursors.
But, for the most part, re-frame is just a mashup of
Re-frame does use Reagent's features in a novel way.
And I did actively reject the current ClojureScript fashion of using
Cursors. And, yes, the event middleware concept has turned out nicely.
But, for the most part, re-frame is simply a mashup of
emerging ideas.
(For the record,
one day I'd love to develop something original and clever).
(For the record, one day I'd love to develop something original and clever).
## Client Side Bias
@ -1092,7 +1100,7 @@ How did that exception happen, you wonder, shaking your head? What did the user
to the exception? What state was the app in that this event was so disastrous?
To debug it, you need to know this information:
1. the state the app immediately before the exception
1. the state of the app immediately before the exception
2. What final event then caused your app to fall in a screaming mess.
Well, with re-frame you need to record (have available):
@ -1169,6 +1177,19 @@ To build an app using re-frame, you'll have to:
- write and register event handler functions (control layer and/or state transition layer).
### Where Do I Go Next?
Your next steps with re-frame should be:
- look at the examples: https://github.com/Day8/re-frame/tree/master/examples
- use the lein template: https://github.com/Day8/re-frame-template​
- read more in the Wiki: https://github.com/Day8/re-frame/wiki
You might also be interested in James MacAulay's excellent work (not re-frame!):
https://github.com/jamesmacaulay/zelkova
If you want reusable layout and widget components, consider this sister project:
https://github.com/Day8/re-com
### Licence
Copyright © 2015 Michael Thompson