Getting Started with the Scrivito Portal App

Getting Started with the Scrivito Portal App

If you would like to try out the Web Interface Builder or create your own Interface-Builder-based website, there is a feature-rich example application, the Scrivito Portal App, a light-weight business website featuring data integration for use on customer portals.

In order to get an impression of how smart the Interface builder is, you don’t need to install the app. Simply register with JustRelate via console.justrelate.com. Your account and Interface Builder trial instance will then be created automatically. Afterwards, click “Edit with Scrivito” in the Console to have your instance provided with the portal example content, and to start using your new website right away.

Editing content in place

All website content can be created and edited using working copies. Using the sidebar to the right, you can create or publish working copies, or open the changes list to see what has been edited so far. Read more about working copies and the published content.

The Interface Builder’s editing interface is truly easy to use: Move the mouse pointer across a page to see the widget frames, click one of their plus icons to add a widget, or use the handle at the top right to open their menu or drag them elsewhere on the page. See the Editor’s Guide for details.

Installing the portal app locally

As a developer, you can install the Portal App locally to use it as the basis of your new website! If you first wish to learn about the concepts behind an Interface-Builder-based app, see How Does an Interface Builder App Work? for an introduction.

After registering with JustRelate via console.justrelate.com as described above, proceed as follows.

Clone and prepare the app

You can find the details on how to clone and prepare the app in the respective ReadMe at GitHub: https://github.com/Scrivito/scrivito-portal-app

In one of the preparation steps, you will be asked to add the ID of your Interface Builder instance to a configuration file. If you are logged in to the JustRelate Console, and have selected your account, copy the “Default instance ID” stated at the bottom right of the “Overview” tab to the clipboard, and paste it to the configuration file.

Set the CORS origin(s)

To enable resource sharing between your Interface Builder instance and your web application, specify the URL(s) of your app on the “Trusted origins” tab in your Console. Click “Add origin” to specify another CORS origin or local URL under which your app will be accessed.

Done! What's next?

Congratulations! You should now be able to use your Interface Builder application, and adapt it according to your demands! To create or change content using the editing interface, open edit.scrivito.com in your browser and specify your local app URL, i.e. http://localhost:8080.

Changes to the “src” subdirectory immediately cause the app to be reloaded and the current page to be redisplayed.

Application errors (caused by, for instance, malfunctioning React components) will show up in the browser console, not in the terminal. In the latter, only compilation errors, issues with library dependencies, etc. are indicated.

Note that the layout, design and images of the Portal App are occasionally updated to reflect current trends, new areas of application, etc.

Have fun!