[RFC] application/storefront-page — create and edit storefront pages for page builder apps

[NguyenQuangHuy-Harry]

Opening this RFC alongside PR #17 (#17), since the README recommends Discussions before a formal PR and we went straight to the PR.

Type: application/storefront-page · Actions: create, edit
One-liner: a merchant-authored storefront page (content + layout) that an app builds and publishes to the online store.

Merchant asks it captures

1. "Build me a landing page for the summer collection launch"
2. "Add a testimonials section to my Black Friday page" (edit)
3. "Spin up a landing page for this ad campaign" (composes with application/ad)

Who would register it: PageFly (both actions) and any page builder in the category.

Status: @adambarrus reviewed on Aug 19 (keep sections, closed page_type enum, publish out of scope, rename to application/storefront-page). Rename pushed Aug 24. Waiting on the consolidated schema-level feedback mentioned for this PR and #14.

Other page-builder developers: if you'd register this type, a 👍 or a comment with your use case helps show category demand.

[charlesdobson]

Hey @NguyenQuangHuy-Harry 👋🏼

We're making application/page available, with create and edit. Thanks for the RFC and #17. We're landing it alongside application/legal-page (#41), which is for app-managed legal and privacy pages.

Some notes:

• Name: we went back to application/page. Where the page appears is now a surface field (storefront or customer-account), so one type covers both without separate type names. That reverses the storefront-page rename we suggested earlier.
• Smaller shared schema: besides id, it has surface, title, and plain-text sections (type, heading, body), so sections stayed in. To keep the shared shape minimal, page_type, handle, goal, products, status, and seo aren't standardized for now. Keep the ones PageFly needs in your own inputSchema.
• value for edit: pass the existing page's ID as the top-level value, not as a field in inputSchema

I'll close #17 in favor of #47 and post here when it's live.

[charlesdobson]

application/page is now available! I'll close the discussion now but please feel free to follow up here with questions.