website icon indicating copy to clipboard operation
website copied to clipboard

Web should be included as an add-to-app platform in the docs

Open jmagman opened this issue 1 year ago • 5 comments

What information needs to be added?

https://docs.flutter.dev/platform-integration/web/embedding-flutter-web exists, but it's not clear in the docs that it's spiritually the same concept as add-to-app (even though it is linked from Add to an existing app > Add to a web app menu).

The docs should be changed to reflect that an existing web app can incrementally add Flutter, not just iOS and Android.

Screenshot 2024-08-05 at 9 44 52 AM

Where should this new content appear?

https://docs.flutter.dev/add-to-app https://docs.flutter.dev/add-to-app/debugging https://docs.flutter.dev/add-to-app/multiple-flutters https://docs.flutter.dev/add-to-app/performance

I would like to fix this problem.

  • [ ] I will try and fix this problem on docs.flutter.dev.

jmagman avatar Aug 05 '24 16:08 jmagman

cc @ditman

jmagman avatar Aug 05 '24 16:08 jmagman

I read the add-to-app bits for mobile, and the technical approach looks very different to what we have in web now, which is what would have been called "multi-view". I'm not sure that it's the same thing, and that's why I only added a small link on the "Add to app" section so people reading add to app documentation can find the web embedding.

I don't mind adding more detail to the add to app section, but I don't want to confuse users by "overloading" the feature name too much? :/

ditman avatar Aug 05 '24 17:08 ditman

cc @mariamhas what do you think about expanding the concept of add-to-app for the sake of web, in terms of "adding Flutter to an existing web app"? The technical details are pretty different, but I suppose the framing is more of a product question. @craiglabenz I know you were looking into our add-to-app docs, do you have an opinion?

jmagman avatar Aug 05 '24 23:08 jmagman

I have long thought of element embedding as web's "add to app", so this makes perfect sense to me.

craiglabenz avatar Aug 06 '24 12:08 craiglabenz

I also thought of element embedding as web's add to app when we first proposed the feature. iframe is also a way to add to app for web so a web add to app section should include both technical approaches since they each have their own use cases as to why a developer may want to use iframe vs element embedding

mariamhas avatar Aug 06 '24 16:08 mariamhas