Collect AI-related content together and standardize titles (#12895)

parlough · gemini-code-assist[bot] · web-flow · commit 192b36c34f4a · 2026-01-07T13:03:09.000-08:00
- Collocates the various AI-related top-level directories under the
top-level `/ai` directory.
- Adds an auto-generated index page at `/ai`.
- Removes the `/resources/ai-overview` page that isn't linked to and is
covered by `/ai/create-with-ai`.
- Renames `/ai/flutter-ext-for-gemini` to `/ai/gemini-cli-extension` to
be more accurate and avoid duplication in the path.
- Updates a few titles to use sentence case as expected by site
standards.
- Adds some custom short titles and breadcrumbs for improved site
navigation and contextualization.

---------

Co-authored-by: gemini-code-assist[bot] &lt;176961590+gemini-code-assist[bot]@users.noreply.github.com&gt;
diff --git a/firebase.json b/firebase.json
@@ -29,6 +29,12 @@
       { "source": "/accessibility", "destination": "/ui/accessibility", "type": 301 },
       { "source": "/adaptations", "destination": "/platform-integration/platform-adaptations", "type": 301 },
       { "source": "/adaptive*", "destination": "/ui/adaptive-responsive", "type": 301 },
+      { "source": "/ai-best-practices", "destination": "/ai/best-practices", "type": 301 },
+      { "source": "/ai-best-practices/:rest*", "destination": "/ai/best-practices/:rest*", "type": 301 },
+      { "source": "/ai-toolkit", "destination": "/ai/ai-toolkit", "type": 301 },
+      { "source": "/ai-toolkit/:rest*", "destination": "/ai/ai-toolkit/:rest*", "type": 301 },
+      { "source": "/ai/flutter-ext-for-gemini", "destination": "/ai/gemini-cli-extension", "type": 301 },
+      { "source": "/ai/best-practices/tool-calls-aka-function-calls", "destination": "/ai/best-practices/tool-calls", "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 },
@@ -182,6 +188,7 @@
       { "source": "/release/breaking-changes/win_lifecycle_process_function", "destination": "/release/breaking-changes/win-lifecycle-process-function", "type": 301 },
       { "source": "/release/archive", "destination": "/install/archive", "type": 301 },
       { "source": "/release/upgrade", "destination": "/install/upgrade", "type": 301 },
+      { "source": "/resources/ai-overview", "destination": "/ai/create-with-ai", "type": 301 },
       { "source": "/resources/books", "destination": "https://docs.flutter.dev/reference/learning-resources", "type": 301 },
       { "source": "/resources/compatibility", "destination": "/release/compatibility-policy", "type": 301 },
       { "source": "/resources/dart-swift-concurrency", "destination": "/get-started/flutter-for/dart-swift-concurrency", "type": 301 },
diff --git a/src/content/ai/ai-rules.md b/src/content/ai/ai-rules.md
@@ -1,5 +1,6 @@
 ---
 title: AI rules for Flutter and Dart
+shortTitle: AI rules
 description: >-
   Learn how to add AI rules to tools that accelerate your
   development workflow.
diff --git a/src/content/ai/ai-toolkit/chat-client-sample.md b/src/content/ai/ai-toolkit/chat-client-sample.md
@@ -4,7 +4,7 @@ description: >
   Learn about the chat client sample included in the AI Toolkit.
 prev:
   title: Custom LLM providers
-  path: /ai-toolkit/custom-llm-providers
+  path: /ai/ai-toolkit/custom-llm-providers
 ---
 
 The AI Chat sample is meant to be a full-fledged chat app built using the
diff --git a/src/content/ai/ai-toolkit/custom-llm-providers.md b/src/content/ai/ai-toolkit/custom-llm-providers.md
@@ -4,10 +4,10 @@ description: >
   How to integrate with other Flutter features.
 prev:
   title: Feature integration
-  path: /ai-toolkit/feature-integration
+  path: /ai/ai-toolkit/feature-integration
 next:
   title: Chat client sample
-  path: /ai-toolkit/chat-client-sample
+  path: /ai/ai-toolkit/chat-client-sample
 ---
 
 The protocol connecting an LLM and the `LlmChatView` is expressed in the
diff --git a/src/content/ai/ai-toolkit/feature-integration.md b/src/content/ai/ai-toolkit/feature-integration.md
@@ -4,10 +4,10 @@ description: >
   How to integrate with other Flutter features.
 prev:
   title: User experience
-  path: /ai-toolkit/user-experience
+  path: /ai/ai-toolkit/user-experience
 next:
   title: Custom LLM providers
-  path: /ai-toolkit/custom-llm-providers
+  path: /ai/ai-toolkit/custom-llm-providers
 ---
 
 In addition to the features that are provided automatically by the
diff --git a/src/content/ai/ai-toolkit/index.md b/src/content/ai/ai-toolkit/index.md
@@ -1,11 +1,12 @@
 ---
-title: AI Toolkit
+title: Flutter AI Toolkit
+shortTitle: AI Toolkit
 description: >
   Learn how to add the AI Toolkit chatbot
   to your Flutter application.
 next:
   title: User experience
-  path: /ai-toolkit/user-experience
+  path: /ai/ai-toolkit/user-experience
 ---
 
 Hello and welcome to the Flutter AI Toolkit!
diff --git a/src/content/ai/ai-toolkit/user-experience.md b/src/content/ai/ai-toolkit/user-experience.md
@@ -4,10 +4,10 @@ description: >
   How the user will experience the AI Toolkit in your app.
 prev:
   title: AI Toolkit overview
-  path: /ai-toolkit/
+  path: /ai/ai-toolkit/
 next:
   title: Feature integration
-  path: /ai-toolkit/feature-integration
+  path: /ai/ai-toolkit/feature-integration
 ---
 
 The [`LlmChatView`][] widget is the entry point for the interactive chat
@@ -190,6 +190,6 @@ documentation.
 [Cupertino app]: {{site.api}}/flutter/cupertino/CupertinoApp-class.html
 [`CupertinoTextField`]:
     {{site.api}}/flutter/cupertino/CupertinoTextField-class.html
-[Custom styling]: /ai-toolkit/feature-integration#custom-styling
+[Custom styling]: /ai/ai-toolkit/feature-integration#custom-styling
 [Material app]: {{site.api}}/flutter/material/MaterialApp-class.html
 [`TextField`]: {{site.api}}/flutter/material/TextField-class.html
diff --git a/src/content/ai/best-practices/developer-experience.md b/src/content/ai/best-practices/developer-experience.md
@@ -5,7 +5,7 @@ description: >
   iterate on high-quality Flutter applications.
 prev:
   title: Mode of interaction
-  path: /ai-best-practices/mode-of-interaction
+  path: /ai/best-practices/mode-of-interaction
 ---
 
 
@@ -153,14 +153,5 @@ Doing this a few times keeps the code in good shape for AI agents and humans
 alike.
 
 
-
-
-
-
-
-
-
-[requirements]:
-    {{site.github}}/flutter/demos/blob/main/crossword_companion/specs/requirements.md
-[tasks-spec]:
-    {{site.github}}/flutter/demos/blob/main/crossword_companion/specs/tasks.md
+[requirements]: {{site.github}}/flutter/demos/blob/main/crossword_companion/specs/requirements.md
+[tasks-spec]: {{site.github}}/flutter/demos/blob/main/crossword_companion/specs/tasks.md
diff --git a/src/content/ai/best-practices/index.md b/src/content/ai/best-practices/index.md
@@ -1,11 +1,13 @@
 ---
 title: Flutter AI best practices
+shortTitle: AI best practices
+breadcrumb: Best practices
 description: >
   Learn best practices for building AI-powered Flutter apps using guardrails to 
   verify and correct AI-generated data.
 next:
   title: Prompting
-  path: /ai-best-practices/prompting
+  path: /ai/best-practices/prompting
 ---
 
 
@@ -57,5 +59,4 @@ practices to use when you're building your own AI apps with Flutter. So let's
 get to it!
 
 
-
-[crossword-app]: {{site.github}}/flutter/demos/tree/main/crossword_companion
+[crossword-app]: {{site.github}}/flutter/demos/tree/main/crossword_companion
diff --git a/src/content/ai/best-practices/mode-of-interaction.md b/src/content/ai/best-practices/mode-of-interaction.md
@@ -5,10 +5,10 @@ description: >
   guardrails to manage nondeterministic AI behavior.
 prev:
   title: Tool calls (aka function calls)
-  path: /ai-best-practices/tool-calls-aka-function-calls
+  path: /ai/best-practices/tool-calls
 next:
   title: Developer experience
-  path: /ai-best-practices/developer-experience
+  path: /ai/best-practices/developer-experience
 ---
 
 
diff --git a/src/content/ai/best-practices/prompting.md b/src/content/ai/best-practices/prompting.md
@@ -5,10 +5,10 @@ description: >
   instructions, dynamic parameters, and versioning techniques.
 prev:
   title: Flutter AI best practices
-  path: /ai-best-practices
+  path: /ai/best-practices
 next:
   title: Structure & output
-  path: /ai-best-practices/structure-output
+  path: /ai/best-practices/structure-output
 ---
 
 
@@ -196,8 +196,7 @@ use [the dotprompt_dart package][dotprompt-dart].
 
 [crossword-readme]: {{site.github}}/flutter/demos/tree/main/crossword_companion
 [gemini-app]: https://gemini.google.com/app
-[ai-toolkit]: https://docs.flutter.dev/ai-toolkit
-[crossword-demo]:
-    {{site.github}}/flutter/demos/raw/refs/heads/main/crossword_companion/readme/screen-recording.mov
+[ai-toolkit]: /ai-toolkit
+[crossword-demo]: {{site.github}}/flutter/demos/raw/refs/heads/main/crossword_companion/readme/screen-recording.mov
 [dotprompt]: https://google.github.io/dotprompt/getting-started/
-[dotprompt-dart]: {{site.pub-pkg}}/dotprompt_dart
+[dotprompt-dart]: {{site.pub-pkg}}/dotprompt_dart
diff --git a/src/content/ai/best-practices/structure-output.md b/src/content/ai/best-practices/structure-output.md
@@ -5,10 +5,10 @@ description: >
   parsable JSON data from an LLM.
 prev:
   title: Prompting
-  path: /ai-best-practices/prompting
+  path: /ai/best-practices/prompting
 next:
   title: Tool calls (aka function calls)
-  path: /ai-best-practices/tool-calls-aka-function-calls
+  path: /ai/best-practices/tool-calls
 ---
 
 
@@ -146,4 +146,3 @@ final cluesData = json['clues'] as Map<String, dynamic>;
 Reliable JSON output from the model is what makes it possible to integrate AI
 into your app. The data might or might not be correct, but it will be in a
 format your app can work with.
-
diff --git a/src/content/ai/best-practices/tool-calls.md b/src/content/ai/best-practices/tool-calls.md
@@ -1,14 +1,15 @@
 ---
 title: Tool calls (aka function calls)
+shortTitle: Tool calls
 description: >
   Learn how to implement tool calling, manage agentic loops, and incorporate 
   human-in-the-loop interactions using the Firebase AI Logic SDK.
 prev:
   title: Structure & output
-  path: /ai-best-practices/structure-output
+  path: /ai/best-practices/structure-output
 next:
   title: Mode of interaction
-  path: /ai-best-practices/mode-of-interaction
+  path: /ai/best-practices/mode-of-interaction
 ---
 
 
@@ -499,4 +500,4 @@ whether it's been a minute or in a month.
 
 
 [dictionary-api]: https://dictionaryapi.dev/
-[completer]: {{site.api}}/flutter/dart-async/Completer-class.html
+[completer]: {{site.api}}/flutter/dart-async/Completer-class.html
diff --git a/src/content/ai/create-with-ai.md b/src/content/ai/create-with-ai.md
@@ -40,7 +40,7 @@ resources:
 
 [Firebase AI Logic]: {{site.firebase}}/docs/ai-logic
 [firebase-ai-logic-docs]: {{site.firebase}}/docs/ai-logic/get-started
-[Flutter AI Toolkit]: {{site.url}}/ai-toolkit
+[Flutter AI Toolkit]: /ai/ai-toolkit
 
 ## AI development tools
 
diff --git a/src/content/ai/gemini-cli-extension.md b/src/content/ai/gemini-cli-extension.md
diff --git a/src/content/ai/index.md b/src/content/ai/index.md
@@ -0,0 +1,7 @@
+---
+title: Flutter & AI
+shortTitle: AI
+layout: toc
+description: >-
+  Learn how to integrate with and use AI to develop Flutter apps.
+---
diff --git a/src/content/ai/mcp-server.md b/src/content/ai/mcp-server.md
@@ -1,5 +1,6 @@
 ---
 title: Dart and Flutter MCP server
+shortTitle: MCP server
 description: >
   Learn about the Dart and Flutter MCP server tool that
   exposes Dart and Flutter tools to compatible
diff --git a/src/content/release/archive-whats-new.md b/src/content/release/archive-whats-new.md
@@ -191,7 +191,7 @@ This website release includes several important updates!
 [Can I use Impeller?]: {{site.main-url}}/go/can-i-use-impeller
 [deep-linking-tool]: /tools/devtools/deep-links
 [design patterns]: /app-architecture/design-patterns
-[Flutter AI Toolkit]: /ai-toolkit
+[Flutter AI Toolkit]: /ai/ai-toolkit
 [fwe]: /get-started/fundamentals
 [Interactive Media Ads]: {{site.pub-pkg}}/interactive_media_ads
 [jc]: /platform-integration/android/compose-activity
diff --git a/src/content/resources/ai-overview.md b/src/content/resources/ai-overview.md
diff --git a/src/data/sidenav.yml b/src/data/sidenav.yml
@@ -177,38 +177,36 @@
   children:
     - title: Create with AI
       permalink: /ai/create-with-ai
-    - title: AI Rules
+    - title: Rules for AI
       permalink: /ai/ai-rules
-    - title: AI Best Practices
-      permalink: /ai-best-practices
-      expanded: false
+    - title: AI best practices
+      permalink: /ai/best-practices
       children:
         - title: Overview
-          permalink: /ai-best-practices
+          permalink: /ai/best-practices
         - title: Prompting
-          permalink: /ai-best-practices/prompting
+          permalink: /ai/best-practices/prompting
         - title: Structure & output
-          permalink: /ai-best-practices/structure-output
+          permalink: /ai/best-practices/structure-output
         - title: Tool calls (aka function calls)
-          permalink: /ai-best-practices/tool-calls-aka-function-calls
+          permalink: /ai/best-practices/tool-calls
         - title: Mode of interaction
-          permalink: /ai-best-practices/mode-of-interaction
+          permalink: /ai/best-practices/mode-of-interaction
         - title: Developer experience
-          permalink: /ai-best-practices/developer-experience
+          permalink: /ai/best-practices/developer-experience
     - title: AI Toolkit
-      permalink: /ai-toolkit
-      expanded: false
+      permalink: /ai/ai-toolkit
       children:
         - title: Overview
-          permalink: /ai-toolkit
+          permalink: /ai/ai-toolkit
         - title: User experience
-          permalink: /ai-toolkit/user-experience
+          permalink: /ai/ai-toolkit/user-experience
         - title: Feature integration
-          permalink: /ai-toolkit/feature-integration
+          permalink: /ai/ai-toolkit/feature-integration
         - title: Custom LLM providers
-          permalink: /ai-toolkit/custom-llm-providers
+          permalink: /ai/ai-toolkit/custom-llm-providers
         - title: Chat client sample
-          permalink: /ai-toolkit/chat-client-sample
+          permalink: /ai/ai-toolkit/chat-client-sample
     - title: GenUI SDK for Flutter
       permalink: /ai/genui
       children:
@@ -223,7 +221,7 @@
     - title: Dart & Flutter MCP server
       permalink: /ai/mcp-server
     - title: Flutter extension for Gemini CLI
-      permalink: /ai/flutter-ext-for-gemini
+      permalink: /ai/gemini-cli-extension
     - title: Firebase AI Logic
       permalink: https://firebase.google.com/docs/ai-logic/get-started?platform=flutter
 
