Skip to content
This repository has been archived by the owner. It is now read-only.
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Netgen Demo Site App

Netgen Demo Site App is a prototype application built with React Native (v0.33) that fetches content from eZ Publish REST API. Application was built for experimental purposes in order to test feasibility of making cross-platform mobile applications atop of eZ CMS.


These instructions will get you a copy of the project up and running on your local machine for development purposes. Instructions will cover dependencies for both Android and iOS platform.

Note that only macOS users can run project on iOS.


Before installing the project, you'll need Node.js, the React Native command line interface and Android Studio. Additionally, if you are macOS user you'll also need Xcode (for building iOS application), while installing Watchmen is also highly recommended. For more reference check the official React Native docs.

iOS users can install Node.js and Watchmen Homebrew:

brew install node
brew install watchman

For installing Node.js on Windows, or one of the Linux distributions, check the following instructions.

Node.js comes with npm, which lets you install the React Native command line interface:

npm install -g react-native-cli
Android Studio installation

Download and install Android Studio if you wish to build and run an application on Android. Additionally, follow official React Native getting started instructions (choose Android and OS you are using) in order to setup whole Android ecosystem properly (Android Studio does not come with Virtual Devices by default). Have in mind that Java Development Kit 1.8 or higher is a base requirement for Android Studio.

Xcode installation (macOS users only)

In order to run an application on iOS, install Xcode is via the Mac App Store. Xcode comes with the iOS Simulator and all the required tools to build a iOS app, so installation should be fairly simple.

Installing the project

After installing all the prerequisites, clone the project and install project dependencies. To do so, open your terminal and enter:

git clone
cd NetgenDemoSiteApp
npm install

Provide content to an application by editing ngdemoappconfig.json.example file in project root and removing .example suffix. Properties restEndpointUrl and siteInfoContentID are mandatory, while articlesPerCategory and contentTypes will fallback to default values. Defining contentTypes is also highly recommended. Configuration restEndpointUrl defines url of eZ installation from which application will fetch content, while siteInfoContentID should be content ID of a, so called, SITE INFO object where content categories are defined. It is an eZ object which must have a main_menu object relation list field, which references objects that represent categories used in application.

iOS requirement only: Adding your domain to NSExceptionDomains

If your REST endpoint does not use HTTPS, you will have to modify ios/NetgenMoreSiteApp/Info.plist file manually in order to fetch content on iOS application. Simply, add the following inside of NSExceptionDomains and change with your endpoint:


Running the app

Finally, you can build and run the application in simulator by typing the following instructions in your terminal:

  • iOS: react-native run-ios
  • Android: react-native run-android

While iOS simulator will start automatically after running react-native run-ios, you'll have to start Android Virtual Device manually before running react-native run-android. For more information about run Android Virtual Devices (AVD) follow this link. It's also possible to run application live on physical device, which is further explained here.

Since React Native still doesn't have stable version (by SemVer), it's very likely that you might run into troubles with setting the project up. Try finding a solution on StackOverflow, because there are a lot of generic issues solved there. However, if you can't solve the issue on your own, don't hesitate with contacting contributor(s) for a help.


Contributions of any kind are welcome. Before submitting the pull request, please make sure your code follows projects linter rules.

Other useful resources/open-source projects for learning React Native

Should be implemented or fixed:

  • Bug: Webview on Android breaks after opening external resource that has redirects
  • Feature: Share on social networks
  • Feature: Search


Netgen Demo Site App is a prototype application built with React Native (v0.33) that fetches content from eZ Publish REST API.




No releases published


No packages published
You can’t perform that action at this time.