Configure apps

App configuration management enables you to define and control your app's core parameters and behavior. It supports local configuration through TOML files for development and control panel management for production environments.

Configuration methods

• Local TOML file: Used in development for local debugging and testing
• Control panel: Used in production for real-time configuration management. Note: The control panel always displays the configuration of the current running version.

Configuration file example

name = "Example App"
client_id = "998336146u8lus58t1fg"
application_url = "https://app.com/" 
embedded = true
handle = "app-handle"

[access_scopes]
scopes = "read_products"

Configuration options

Basic settings

Property	Required	Type	Description
name	Yes	String	Name displayed in store
handle	No	String	Path in admin backend, for example https://admin.genstore.com/store/your-store-name/apps/your-app-handle/app Note: Changes affect sidebar menu access URL
client_id	Yes	String	Unique app identifier
application_url	Yes	URL string	App access URL Note: Extensions without UI use default: https://genstore.dev/apps/default-app-home
embedded	Yes	Boolean	Determines if app runs embedded in store admin

Access permissions

The access_scopes section defines permission requests:

Property	Required	Type	Description
scopes	Yes	String List	Required permissions, separated by commas