Adaptive and responsive docs

.devcontainer/devcontainer.json

@@ -11,8 +11,16 @@
  "remoteEnv": {
  "PATH": "${containerEnv:PATH}:${containerEnv:FLUTTER_ROOT}/bin"
  },
+<<<<<<< HEAD
+ "onCreateCommand": "git clone --branch=stable https://github.com/flutter/flutter.git ${containerEnv:FLUTTER_ROOT} && ${containerEnv:FLUTTER_ROOT}/bin/flutter doctor",
+<<<<<<< HEAD
+ "postCreateCommand": "git submodule update --init --recursive && flutter pub get && pnpm install",
+=======
+=======
  "onCreateCommand": "git clone --branch=stable https://github.com/flutter/flutter.git ${FLUTTER_ROOT} && ${FLUTTER_ROOT}/bin/flutter doctor",
+>>>>>>> main
  "postCreateCommand": "git submodule update --init --recursive && flutter pub get && corepack install && pnpm install",
+>>>>>>> main
  "customizations": {
  "vscode": {
  "extensions": ["Dart-Code.dart-code", "Dart-Code.flutter"]

examples/ui/layout/adaptive_app_demos/pubspec.yaml → examples/ui/adaptive_app_demos/pubspec.yaml

@@ -17,7 +17,7 @@ dependencies:
 
 dev_dependencies:
  example_utils:
- path: ../../../example_utils
+ path: ../../example_utils
  flutter_test:
  sdk: flutter
 

firebase.json

@@ -28,7 +28,7 @@
 
  { "source": "/accessibility", "destination": "/ui/accessibility-and-internationalization/accessibility", "type": 301 },
  { "source": "/adaptations", "destination": "/platform-integration/platform-adaptations", "type": 301 },
- { "source": "/adaptive*", "destination": "/ui/layout/responsive/adaptive-responsive", "type": 301 },
+ { "source": "/adaptive*", "destination": "/ui/adaptive-responsive", "type": 301 },
  { "source": "/android-release", "destination": "/deployment/android", "type": 301 },
  { "source": "/animations", "destination": "/ui/animations", "type": 301 },
  { "source": "/animations/:rest*", "destination": "/ui/animations/:rest*", "type": 301 },
@@ -189,12 +189,12 @@
  { "source": "/ui/advanced/splash-screen", "destination": "/platform-integration/android/splash-screen", "type": 301 },
  { "source": "/ui/advanced/typography", "destination": "/ui/design/text/typography", "type": 301 },
  { "source": "/ui/assets-and-images", "destination": "/ui/assets/assets-and-images", "type": 301 },
- { "source": "/ui/building-adaptive-apps", "destination": "/ui/layout/responsive/building-adaptive-apps", "type": 301 },
+ { "source": "/ui/building-adaptive-apps", "destination": "/ui/adaptive-responsive", "type": 301 },
  { "source": "/ui/interactive", "destination": "/ui/interactivity", "type": 301 },
- { "source": "/ui/layout/adaptive-responsive", "destination": "/ui/layout/responsive/adaptive-responsive", "type": 301 },
+ { "source": "/ui/layout/adaptive-responsive", "destination": "/ui/adaptive-responsive", "type": 301 },
  { "source": "/ui/layout/box-constraints", "destination": "/ui/layout/constraints#unbounded", "type": 301 },
- { "source": "/ui/layout/building-adaptive-apps", "destination": "/ui/layout/responsive/building-adaptive-apps", "type": 301 },
- { "source": "/ui/layout/responsive", "destination": "/ui/layout/responsive/adaptive-responsive", "type": 301 },
+ { "source": "/ui/layout/building-adaptive-apps", "destination": "/ui/adaptive-responsive", "type": 301 },
+ { "source": "/ui/layout/responsive", "destination": "/ui/adaptive-responsive", "type": 301 },
  { "source": "/ui/material", "destination": "/ui/design/material", "type": 301 },
  { "source": "/ui/material3-updates", "destination": "/ui/design/material", "type": 301 },
  { "source": "/ui/scrolling", "destination": "/ui/layout/scrolling", "type": 301 },
@@ -234,7 +234,7 @@
  { "source": "/go/a11y-links", "destination": "https://docs.google.com/document/d/1FxzANiyJFkoRxJ7V2IejpfB5DX19gxiJps-8N2oUW_U/edit#", "type": 301 },
  { "source": "/go/a11y-text-attributes", "destination": "https://docs.google.com/document/d/1vhbwxFOTRTUvW2C_onFffEH5Fn2pAfMQDyv-gekias0/edit?usp=sharing&resourcekey=0-ChQvjIoWYO7jXcaCXMj5Qw", "type": 301 },
  { "source": "/go/actions-and-shortcuts-design-revision", "destination": "https://docs.google.com/document/d/1A9yald55O_C6Weqp4tOtyMisfOC1ZC0UMq7Yc-pNfVQ/edit", "type": 301 },
- { "source": "/go/adaptive", "destination": "/ui/layout/responsive/building-adaptive-apps", "type": 301 },
+ { "source": "/go/adaptive", "destination": "/ui/adaptive-responsive", "type": 301 },
  { "source": "/go/adaptive-layout-foldables", "destination": "https://docs.google.com/document/d/1qhrpTWYs5f67X8v32NCCNTRMIjSrVHuaMEFAul-Q_Ms/edit?usp=sharing", "type": 301 },
  { "source": "/go/add-missing-features-to-selection-controls", "destination": "https://docs.google.com/document/d/1QizXwBiO-2REIcEovl5pK06BaLPOWYmNwOE5jactJZA/edit?usp=sharing&resourcekey=0-1pb9mJiAq29Gesmt25GAug", "type": 301 },
  { "source": "/go/add-to-app-samples", "destination": "https://docs.google.com/document/d/1M_GsAL8C1NxbsmzI35w2Th1wvX1KMoPHY5yeeNbzjY0", "type": 301 },

src/_data/sidenav.yml

@@ -168,18 +168,24 @@
  permalink: /cookbook/lists/floating-app-bar
  - title: Create a scrolling parallax effect
  permalink: /cookbook/effects/parallax-scrolling
- # TODO(parlough): Rename this to 'Responsive design'
- # and add 'Adaptive design' under 'Design & theming'.
- - title: Adaptive design
- permalink: /ui/layout/responsive
- children:
- - title: Adaptive and responsive app design
- permalink: /ui/layout/responsive/adaptive-responsive
- - title: Build an adaptive app
- permalink: /ui/layout/responsive/building-adaptive-apps
- - title: Update app UI based on orientation
- permalink: /cookbook/design/orientation
-
+- title: Adaptive & responsive design
+ permalink: /ui/adaptive-responsive
+ children:
+ - title: Overview
+ permalink: /ui/adaptive-responsive
+ match-page-url-exactly: true
+ - title: General approach
+ permalink: /ui/adaptive-responsive/general
+ - title: SafeArea & MediaQuery
+ permalink: /ui/adaptive-responsive/safearea-mediaquery
+ - title: Large screens & foldables
+ permalink: /ui/adaptive-responsive/large-screens
+ - title: User input & accessibility
+ permalink: /ui/adaptive-responsive/input
+ - title: Best practices
+ permalink: /ui/adaptive-responsive/best-practices
+ - title: Additional resourcres
+ permalink: /ui/adaptive-responsive/more-info
 - title: Design & theming
  permalink: /ui/design
  children:
@@ -667,6 +673,8 @@
  permalink: /tools/devtools/app-size
  - title: DevTools extensions
  permalink: /tools/devtools/extensions
+ - title: Validate deep links
+ permalink: /tools/devtools/deep-links
  - title: Release notes
  permalink: /tools/devtools/release-notes
  - title: SDK overview

src/content/get-started/flutter-for/swiftui-devs.md

@@ -1374,7 +1374,7 @@ To review a complete walkthrough, check out the [video_player example][].
 [Wonderous]: https://flutter.gskinner.com/wonderous/?utm_source=flutterdocs&utm_medium=docs&utm_campaign=iosdevs
 [video_player]: {{site.pub-pkg}}/video_player
 [video_player example]: {{site.pub-pkg}}/video_player/example
-[Creating responsive and adaptive apps]: /ui/layout/responsive/adaptive-responsive
+[Creating responsive and adaptive apps]: /ui/adaptive-responsive
 [`MediaQuery.of()`]: {{site.api}}/flutter/widgets/MediaQuery-class.html
 [`CustomPaint`]: {{site.api}}/flutter/widgets/CustomPaint-class.html
 [`CustomPainter`]: {{site.api}}/flutter/rendering/CustomPainter-class.html

src/content/platform-integration/web/faq.md

@@ -119,9 +119,9 @@ If you encounter problems, please [file an issue][].
 
 Use [Flutter DevTools][] for the following tasks:
 
-* [debugging][]
-* [logging][]
-* [running Flutter inspector][]
+* [Debugging][]
+* [Logging][]
+* [Running Flutter inspector][]
 
 Use [Chrome DevTools][] for the following tasks:
 
@@ -145,18 +145,18 @@ Not currently.
 [Analyzing performance]: {{site.developers}}/web/tools/chrome-devtools/evaluate-performance
 [building a web app with Flutter]: /platform-integration/web/building
 [Chrome DevTools]: {{site.developers}}/web/tools/chrome-devtools
-[Creating responsive apps]: /ui/layout/responsive/adaptive-responsive
-[debugging]: /tools/devtools/debugger
+[Creating responsive apps]: /ui/adaptive-responsive
+[Debugging]: /tools/devtools/debugger
 [file an issue]: {{site.repo.flutter}}/issues/new?title=[web]:+%3Cdescribe+issue+here%3E&labels=%E2%98%B8+platform-web&body=Describe+your+issue+and+include+the+command+you%27re+running,+flutter_web%20version,+browser+version
 [Flutter DevTools]: /tools/devtools/overview
 [Generating event timeline]: {{site.developers}}/web/tools/chrome-devtools/evaluate-performance/performance-reference
 [`http`]: {{site.pub}}/packages/http
 [`iframe`]: https://html.com/tags/iframe/
 [isolates]: {{site.dart-site}}/guides/language/concurrency
 [Issue 32248]: {{site.repo.flutter}}/issues/32248
-[logging]: /tools/devtools/logging
+[Logging]: /tools/devtools/logging
 [Preparing a web app for release]: /deployment/web
-[running Flutter inspector]: /tools/devtools/inspector
+[Running Flutter inspector]: /tools/devtools/inspector
 [Upgrading from package:flutter_web to the Flutter SDK]: {{site.repo.flutter}}/wiki/Upgrading-from-package:flutter_web-to-the-Flutter-SDK
 [widget tests]: /testing/overview#widget-tests
 [Web support for Flutter]: /platform-integration/web

src/content/platform-integration/web/index.md

@@ -83,7 +83,7 @@ The following resources can help you get started:
 ---
 
 [Building a web application with Flutter]: /platform-integration/web/building
-[Creating responsive apps]: /ui/layout/responsive/adaptive-responsive
+[Creating responsive apps]: /ui/adaptive-responsive
 [Discord]: https://discordapp.com/invite/yeZ6s7k
 [file an issue]: https://goo.gle/flutter_web_issue
 [Wonderous app]: {{site.wonderous}}/web

src/content/release/archive-whats-new.md

@@ -684,7 +684,7 @@ null safety, but that work is not yet completed.
 
 **Docs updated or added since the 2.0 release**
 
-* A new page on [Building adaptive apps][].
+* A new page on Building adaptive apps.
 * A new page describing how to use [Google APIs][]
  with Flutter.
 * A new landing page for [Embedded Support for Flutter][].
@@ -746,7 +746,6 @@ publication since the last stable release:
 
 [Adding in-app purchases to your Flutter app]: {{site.codelabs}}/codelabs/flutter-in-app-purchases
 [Announcing Flutter 2.2]: {{site.flutter-medium}}/announcing-flutter-2-2-at-google-i-o-2021-92f0fcbd7ef9
-[Building adaptive apps]: /ui/layout/responsive/building-adaptive-apps
 [Build Voice Bots for Android with Dialogflow Essentials & Flutter]: {{site.codelabs}}/codelabs/dialogflow-flutter
 [Building your first Flutter app]: {{site.yt.watch}}?v=Z6KZ3cTGBWw
 [DartPad Sharing Guide (using a Gist file)]: {{site.github}}/dart-lang/dart-pad/wiki/Sharing-Guide
@@ -846,7 +845,7 @@ publication since the last stable release:
 [Announcing Flutter 2]: {{site.google-blog}}/2021/03/announcing-flutter-2.html
 [comp]: {{site.flutter-medium}}/providing-operating-system-compatibility-on-a-large-scale-374cc2fb0dad
 [Configuring the URL strategy on the web]: /ui/navigation/url-strategies
-[Creating responsive and adaptive apps]: /ui/layout/responsive/adaptive-responsive
+[Creating responsive and adaptive apps]: /ui/adaptive-responsive
 [Dart sound null safety: technical preview 2]: {{site.flutter-medium}}/null-safety-flutter-tech-preview-cb5c98aba187
 [Deprecation Lifetime in Flutter]: {{site.flutter-medium}}/deprecation-lifetime-in-flutter-e4d76ee738ad
 [Desktop support for Flutter]: /platform-integration/desktop
@@ -1261,7 +1260,7 @@ Happy Fluttering!
 [building a web application]: /platform-integration/web/building
 [`ColorFiltered`]: {{site.api}}/flutter/widgets/ColorFiltered-class.html
 [ColorFiltered demo]: {{site.github}}/csells/flutter_color_filter
-[creating responsive apps]: /ui/layout/responsive/adaptive-responsive
+[creating responsive apps]: /ui/adaptive-responsive
 [Flutter for web]: /platform-integration/web
 [Flutter news from GDD China: uniting Flutter on web and mobile, and introducing Flutter 1.9]: {{site.google-blog}}/2019/09/flutter-news-from-gdd-china-flutter1.9.html?m=1
 [Improving Flutter's Error Messages]: {{site.flutter-medium}}/improving-flutters-error-messages-e098513cecf9

src/content/tools/devtools/deep-links.md

@@ -0,0 +1,26 @@
+---
+title: Validate deep links
+description: Learn how to validate deep links in your app.
+---
+
+:::note
+The deep linking validator was added to DevTools
+in Flutter SDK 19. It currently works only for
+Android, but will be expanded to cover iOS and
+web in future releases.
+:::
+
+The deep linking view validates the deep links
+on your app.
+
+You can open DevTools, click into the **Deep Links** tab,
+and import a Flutter project that contains deeplinks.
+
+[PENDING: Needs a screenshot]
+
+This tool helps you identify and troubleshoot any errors
+in your Android deep link setup,
+from website configuration to Android manifest files.
+DevTools provides clear instructions on how to fix any issues,
+making the implementation process much easier. 
+

src/content/tools/devtools/overview.md

@@ -7,7 +7,7 @@ description: How to use Flutter DevTools with Flutter.
 
 DevTools is a suite of performance and debugging tools
 for Dart and Flutter.
-Flutter DevTools_ and _Dart DevTools_ refer to the
+_Flutter DevTools_ and _Dart DevTools_ refer to the
 same set of tools.
 
 ![Dart DevTools Screens](/assets/images/docs/tools/devtools/dart-devtools.gif){:width="100%"}
@@ -34,6 +34,7 @@ Here are some of the things you can do with DevTools:
  about a running Flutter or Dart
  command-line app.
 * Analyze code and app size.
+* Validate deep links in your Android app.
 
 We expect you to use DevTools in conjunction with
 your existing IDE or command-line based development workflow.