MicrosoftEdge / MSEdgeExplainers

Home for explainer documents originated by the Microsoft Edge team
Creative Commons Attribution 4.0 International
1.29k stars 205 forks source link

[Web Install] Rename to "Cross-Domain Web Install API" #657

Closed dfabulich closed 1 year ago

dfabulich commented 1 year ago

I think it's confusing to call this the "Web Install API," because that makes it sounds like the first/only API to install web apps.

(I also think it'll be confusing to call it navigator.install to developers who don't know about onbeforeinstallprompt.)

Imagine a new developer developing their first PWA stumbling across this API, and thinking that this is what they need to use to make their PWA installable.

I think this feature should be called "Cross-Domain Web Install API", with a navigator.installCrossDomain method.

diekus commented 1 year ago

Hi @dfabulich thanks for the feedback. I agree it can be confusing that install only works cross domain, but I promise that is not the intention. We're evaluating internally how can we re-design to hopefully enable same origin installs as well.

diekus commented 1 year ago

Bringing back a navigator.install (present in the early explainer) that works in same-domain sites. See draft here: https://github.com/diekus/MSEdgeExplainers/blob/main/WebInstall/explainer.md

diekus commented 1 year ago

@dfabulich we're pushing for a unified way of installing apps, both same/cross domain. Thanks for the feedback.