re-frame/examples/todomvc/README.md

57 lines
1.5 KiB
Markdown

# TodoMVC done with re-frame
A [re-frame](https://github.com/Day8/re-frame) implementation of [TodoMVC](http://todomvc.com/).
## Setup And Run
1. Install [Leiningen](http://leiningen.org/) (plus Java).
1. Get the re-frame repo
```
git clone https://github.com/Day8/re-frame.git
```
1. cd to the right example directory
```
cd re-frame/examples/todomvc
```
1. clean build
```
lein do clean, cljsbuild once
```
1. run
```
open index.html
```
## Exploring The Code
From the re-frame readme:
```
To build a re-frame app, you:
- design your app's data structure (data layer)
- write and register subscription functions (query layer)
- write Reagent component functions (view layer)
- write and register event handler functions (control layer and/or state transition layer)
```
In `src`, there's a matching set of files (each small):
```
src
├── core.cljs <--- entry point, plus history
├── db.cljs <--- data related (data layer)
├── subs.cljs <--- subscription handlers (query layer)
├── views.cljs <--- reagent components (view layer)
└── handlers.cljs <--- event handlers (control/update layer)
```
## Notes
Various:
- The [offical reagent example](https://github.com/reagent-project/reagent/tree/master/examples/todomvc).
- There's also a sibling example (under construction) called TodoMVC-plus which is a more complete example, including testing etc.
- Look at the [re-frame Wiki](https://github.com/Day8/re-frame/wiki).