## Tutorials

1. [Using Hiccup to Describe HTML](UsingHiccupToDescribeHTML.md)
2. [Creating Reagent Components](CreatingReagentComponents.md)
3. [Using [square brackets] instead of (parentheses)](UsingSquareBracketsInsteadOfParens.md)
4. [When do components update?](WhenDoComponentsUpdate.md)
5. [[WIP] Managing State: atoms, cursors, Reactions, and tracking](ManagingState.md)
6. [Batching and Timing: How Reagent Renders Changes to Application State](BatchingAndTiming.md)
7. [Interop with React](InteropWithReact.md)
8. [React Features](ReactFeatures.md) and how to use them in Reagent

Also:
  * [purelyfunctional.tv ](https://purelyfunctional.tv/guide/reagent/) - an excellent, written tutorial
  * [Reagent Deep Dive Series by Timothy Pratley](http://timothypratley.blogspot.com.au/p/p.html) - a four part series
  * [Reagent Mysteries series by Paulus Esterhazy](https://presumably.de/) - a four part series
  * [Props, Children & Component Lifecycle](https://www.martinklepsch.org/posts/props-children-and-component-lifecycle-in-reagent.html) by Martin Klepsch
  * [Using Stateful JS Components - like D3](https://github.com/Day8/re-frame/blob/master/docs/Using-Stateful-JS-Components.md)  (external link)

## Commercial Videos Series

  * [Learn Reagent Free](https://www.jacekschae.com/learn-reagent-free/tycit?coupon=REAGENT)
  * [Learn Reagent Pro](https://www.jacekschae.com/learn-reagent-pro/tycit?coupon=REAGENT) (Affiliate link, $30 discount)
  * [Learn Re-frame](https://www.jacekschae.com/learn-re-frame-pro?coupon=REAGENT) (Affiliate link, early access)
  * [purelyfunctional.tv ](https://purelyfunctional.tv/guide/reagent/)
  * [Lambda Island Videos](https://lambdaisland.com/collections/react-reagent-re-frame)

## Frequently Asked Questions

1. [Why isn't my Component re-rendering?](FAQ/ComponentNotRerendering.md)
1. [How do I use React's "refs"](FAQ/UsingRefs.md)
2. [How can I use an entity like "nbsp"?](FAQ/UsingAnEntity.md)
3. [Why is my attribute (like autoFocus) missing?](FAQ/MyAttributesAreMissing.md)
4. [How can I use React's dangerouslySetInnerHTML?](FAQ/dangerouslySetInnerHTML.md)
5. [Reagent doesn't work after updating dependencies](FAQ/CljsjsReactProblems.md)
5. [How do I force Component re-creation?](https://groups.google.com/forum/#!topic/reagent-project/tNY4gzk7TUY) (external link)
6. [How do I access "props" in lifecycle methods?](http://nils-blum-oeste.net/clojurescripts-reagent-using-props-in-lifecycle-hooks/) (external link)

## Examples

- [MaterialUI v1 with working TextField](examples/material-ui.md), React interop example
- [React-sortable-hoc](../examples/react-sortable-hoc/src/example/core.cljs), React interop example


### Want To Add An FAQ?

Many Thanks!! We'd like that:
1. As a base, just use the structure from one of the existing FAQs files
2. Give us a PR which includes your new file AND a change to this README so your entry is listed.

#### Misc Docs

 - [0.8-upgrade](0.8-upgrade.md)
 - [development](development.md)