react-applications

Write applications with only React and this library! Simply use this to create a configuration document/object or watch and react to the components changing over time.

Usage (API)

You can use the synchronous API by just calling react-applications with some JSX elements.

const React = require('react')
const reactApps = require('react-applications')
 
function MyComp(props) { return props.children }
const structure = reactApps(<MyComp><div foo="bar" /></MyComp>)
console.log(structure)
/*
MyComp {
  state: {},
  children:
  [ { type: 'div', key: null, props: [{ foo: 'bar' }], children: [] } ],
  props: {},
  type: [Function: MyComp] }
*/

You can mix objects and JSX at will.

const React = require('react')
const reactApps = require('react-applications')
 
function MyComp() { return { foo: 'bar' } }
console.log(reactApps(<MyComp />))
/* { foo: 'bar' } */

Dynamic mode

You can also watch for changes in the components. To do this provide an onChange function. You can also use componentDidUpdate in your components as long as you pass onChange or set the dynamic: true option.

const ClassComponent extends React.Component {
  componentDidUpdate(prevProps, prevState, snapshot) {
    console.log('Component updated! Yay!') 
  }
  componentDidMount() {
    this.setState({ foo: 'bar' })
  }
}
const structure = reactApps(<ClassComponent />, {
  onChange: (oldState, newState) => {
    const diff = require('json-diff')(oldState, newState)
    console.log(oldState, newState, diff)  // previous component, current component, and diff between
  }
})
// And it's all mounted synchronously
structure.state // { foo: 'bar' }