Home

Welcome to the PackageFactory.Guevara wiki! This page hosts developer documentation and conventions.

Getting Started

Please follow the instructions in the README for getting started! This documentation is mainly for developers of this package.

Overall folder structure

The JS frontend of this code resides in Resources/Private/JavaScript.

As this package uses a Guest iFrame for rendering the actual website, we have two JS contexts which communicate with each other. The "outer frame" which contains the Neos UI is called host, while the iFrame containing the website is called the guest.

This structure is reflected in the sub-folder/package structure:

• Host: the main application of Neos.
  • This is the React.JS/Redux application.
• Guest: the connector running inside the guest frame.
• API: TODO: explain
  • TODO: where is the API available and connected?
• Login: The login screen. Currently not used.
• Shared: helper functions which are necessary both inside the guest and the host.
  • Should not contain state!
  • We try to get rid of these functions!

TODO: explain how the guest and the host frame communicate.

Our Style of Writing React.js

TODO

• React Style
  • stateless functional components
• especially plow.js
  • currently Immutable.js not included; but important in the longer run.
• Redux-Saga (how it is used)

Testing

TODO

Redux State Structure

TODO

Functional Programming Basics

TODO

Glossary

• Node
• StoredNode
• StoredNodeType / NodeType