Skip to content

Conversation

@danidelcar
Copy link
Contributor

@danidelcar danidelcar commented Jan 14, 2026

Purpose of this pull request

This PR introduces the App Management documentation section, providing comprehensive guidance for developers and merchants on installing, configuring, and managing App Builder applications in Adobe Commerce.

Summary of changes

New documentation section: App Management

Created four new documentation pages under /src/pages/app-management/:

File Description
index.md Overview of App Management with key benefits, requirements, and how it works
app-metadata.md Reference for defining metadata in app.commerce.config
configuration-schema.md Reference for defining configuration schemas in app.commerce.config
runtime-actions.md Guide to initializing the configuration library and understanding auto-generated runtime actions
associate-apps.md Instructions for associating apps with Commerce instances and configuring business settings

All pages include a beta warning banner:

Adobe Commerce App Management is for Beta users only and is not yet accessible to all customers.

And a new metadata keyword: App Management

Additional info

JIRA CEXT-5668
Preview branch

@danidelcar danidelcar self-assigned this Jan 14, 2026
@danidelcar danidelcar added the enhancement New feature or request label Jan 14, 2026
@github-project-automation github-project-automation bot moved this to 📋 Needs Review in Commerce - Pull Requests Jan 14, 2026
@danidelcar danidelcar changed the title Introduces the **App Management** documentation section Introduces the App Management documentation section Jan 14, 2026
@danidelcar danidelcar marked this pull request as draft January 14, 2026 13:32
@danidelcar danidelcar changed the title Introduces the App Management documentation section CEXT-5668: Introduces the App Management documentation section Jan 14, 2026
@danidelcar danidelcar marked this pull request as ready for review January 15, 2026 11:37
@danidelcar danidelcar requested a review from keharper January 15, 2026 14:28
@github-project-automation github-project-automation bot moved this from 📋 Needs Review to 🛠 Changes Requested in Commerce - Pull Requests Jan 15, 2026
Copy link
Contributor

@keharper keharper left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't understand the audience. Is it for developers for packaging their apps? Merchants who have purchased an app?

Copy link
Collaborator

@iivvaannxx iivvaannxx left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's good we encourage usage of the init script, that's what I wrote it, to automate the burden of all the manual steps required. But I feel we should document the actual manual setup so developers understand it end-to-end.

The script does a lot of "magic" and that can cause confusion if something fails. If developers understand what the script is doing, they can ensure everything is correctly configured by themselves.

This is what it's done in the usage guide.

@danidelcar danidelcar requested a review from meker12 January 19, 2026 08:19
@github-project-automation github-project-automation bot moved this from 🛠 Changes Requested to 👍 Approved in Commerce - Pull Requests Jan 19, 2026
danidelcar and others added 5 commits January 19, 2026 18:25
Co-authored-by: Ivan Porto Wigner <dev.ivanporto@gmail.com>
Co-authored-by: Ivan Porto Wigner <dev.ivanporto@gmail.com>
@danidelcar danidelcar requested a review from iivvaannxx January 20, 2026 08:38
@danidelcar danidelcar merged commit 3247bff into main Jan 20, 2026
10 checks passed
@danidelcar danidelcar deleted the del-app-mgmt branch January 20, 2026 10:49
@github-project-automation github-project-automation bot moved this from 👍 Approved to 🏁 Done in Commerce - Pull Requests Jan 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

Status: 🏁 Done

Development

Successfully merging this pull request may close these issues.

7 participants