App Framework
This document helps you understand what the Hygraph App Framework is and what you can do with it. With the App Framework, you can extend the core capabilities that Hygraph offers. It gives you the possibility to create your own custom apps, and (optionally) share them with other users.
The App Framework is a toolset that allows you to build apps easily. You can use it to build apps that integrate Hygraph with third-party services, or build custom integrations tailored to your specific needs.
Look into our App Framework tutorial.
#What are apps?
Apps are packages that extend Hygraph in various ways. Apps allow for simpler customization and integration of your project with other tools, products and services. With apps, you can adapt Hygraph to your individual or business needs.
#What can apps do?
With apps, you can extend the out-of-the-box Hygraph functionality and User Interface in various ways. From small custom field extensions to full fledged product integrations, with the App Framework & your custom apps it becomes super easy to extend Hygraph to meet your needs.
Some common use cases are:
- Adding custom fields to your models
- Customizing the content editing sidebar to improve the editor experience
- Triggering actions such as CI builds in third-party systems
For inspiration on what's possible with the App Framework, check out the publicly available apps in our Marketplace.
#Why apps?
Apps offer an improvement over the UI Extensions feature, which will eventually be deprecated. We encourage all users to migrate from UIX to apps.
Why migrate from UIX to the App Framework?
The App Framework offers more flexibility and greater security features:
#Flexibility
Creating your own app to be used in the Hygraph platform allows you to have custom fields on your setup, as well as custom functionality on your CMS. You can even group up all your custom elements under one app and install them at once, which greatly simplifies the installation process compared to UI Extensions.
It also makes it possible for you to create custom page views, which was not possible before.
#Security
Certain resources are critical for an app to work, and should therefore be hidden from users to prevent accidental removal. Our App Framework offers a permissions system, which allows better control over resources visibility as well as over creating resources on behalf of the user.
With this new permissions system you can create the app establishing which resources should be hidden from users, and also which resources are critical and can't be removed once the app is uninstalled.
#Section contents
This section offers a contents map to help you readily find what you're looking for.
#Getting started
| Document | Contents |
|---|---|
| Overview | Hygraph's App Framework overview. |
| Migrate to apps | Contains information on how to migrate from UI Extension to app. Includes a step-by-step example for both Field UIX and Sidebar UIX. |
| Register an app | Contains all the information you need about the app registration process. |
| Using app tokens | Contains information on how to generate app tokens for your app. |
| Install an app | Contains information on how to install an app in your Hygraph Project. |
| Delete an app | Contains information on how to delete an app you've created. |
#First steps
This is our App Framework tutorial. Take the first steps into creating an app with field, sidebar, or page elements.
| Document | Contents |
|---|---|
| Overview | App Framework tutorial overview document stating what you will learn as well as the prerequisites. |
| Register your app | Contains instructions on how to register your app. |
| Develop your app | Contains instructions on how to develop an application. |
| Installation flow | Contains instructions on how to develop your app's installation flow. |
| Configuration flow | Contains instructions on how to develop your app's configuration flow. |
| Field element | Contains instructions on how to develop a custom field element. |
| Sidebar element | Contains instructions on how to develop a custom sidebar element. |
| Page element | Contains instructions on how to develop a custom page element. |
#Quick starters
| Document | Contents |
|---|---|
| Next.js | Contains instructions on how to build an app with a custom field element using our Next.js starter. |
#Field elements
| Document | Contents |
|---|---|
| List renderer | Contains instructions on how to enable custom list rendering in your app. |
| Table renderer | Contains instructions on defining how custom field values are displayed in the content table. |
| Declaration | Contains information about field element declaration properties. |
#Sidebar elements
| Document | Contents |
|---|---|
| Declaration | Contains information about sidebar element declaration properties. |
#API Reference
| Document | Contents |
|---|---|
| Common props | App Framework API reference for common props to all elements. |
| Field element | App Framework API reference for field element. |
| Sidebar element | App Framework API reference for sidebar element. |
| Additional types | App Framework API reference for additional types. It includes model, form, locale, stage, user, dialog, and toasts. |
#Functions
| Document | Contents |
|---|---|
| OpenDialog | OpenDialog function documentation. |
| ShowToast | ShowToast function documentation. |
| ToastOptions | ToastOptions function documentation. |
| useFieldExtension | useFieldExtension hook documentation. |
| useFormSidebarExtension | useFormSidebarExtension hook documentation. |
| useApp | useApp hook documentation. |
#Constants
| Document | Contents |
|---|---|
| Constants | List of constants with their descriptions, types, and values. |
#Examples
| Document | Contents |
|---|---|
| openAssetPicker | Contains an example that will help you use the openAssetPicker method. |
#Libraries
| Document | Contents |
|---|---|
| React SDK | Link to our App Framework React SDK. |
| JavaScript SDK | Link to our JavaScript SDK. |