React for Zendesk App Framework V2.0
NPM: Direct from NPM or install with Homebrew
$ brew install node
Add this line to your application's Gemfile:
gem 'zaf_react'And then execute:
$ bundle
Or install it yourself as:
$ gem install zaf_react
$ zafr init
This will generate a very basic React app with an example component "src/components/item-list/item-list.js".
$ zafr start
This will run the React server on localhost:3000.
$ zafr build
This will compile the React app into a production ready build. This will not run if uploaded to Zendesk. See below.
$ zafr server
This will run the previous zafr build command, then start the ZAT Server for local testing in Zendesk. See Zendesk's docs here for using the ZAT server here.
$ zafr validate
This will run the zat validate command in the /build directory to validate the ZAF V2.0 App.
$ zafr package
This will run the above zafr build command, then flatten the React assets directory structure, and finally compile the entire app into a ZAF V2.0 app ready for upload to Zendesk. The uploadable .zip file can be found at /build/tmp/app-{timstamp}.zip.
Zendesk's ZAFClient is not available outside of Zendesk. In order to allow local testing, without any need for Zendesk, use the file /source/src/zendesk/helpers/zaf_test_client.js. There you can build methods to simulate the ZAFClient functionality away from the Zendesk environment. The ZAF Test Client will not be used when uploaded to Zendesk or when using the ZAT Server.
During the zafr package command, all React style and js assets will be flattened and moved from /build/assets/static/* to /build/assets/* as ZAF V2.0 does not allow a nested file structure.
Bug reports and pull requests are welcome on GitHub at https://github.com/onlyexcellence/zaf_react.