Merge pull request #1598 from unoplatform/mergify/bp/release/stable/6.0/pr-1597

agneszitte · web-flow · commit 25d5ed1b611e · 2025-12-02T19:09:25.000-05:00
diff --git a/doc/cupertino-controls-styles.md b/doc/cupertino-controls-styles.md
@@ -4,6 +4,9 @@ uid: Uno.Themes.Cupertino.Styles
 
 # Cupertino Controls Styles
 
+> [!IMPORTANT]
+> UnoFeatures: **Cupertino** — add `<UnoFeatures>Cupertino</UnoFeatures>` to your app's `.csproj` to include Uno Cupertino resources.
+
 | Control                     | Style Key                                                                                                                                                                                                                                                                                                                      |
 |-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | `Button`                    | `CupertinoButtonStyle`<br/>`CupertinoContainedButtonStyle`<br/>`CupertinoDatePickerFlyoutButtonStyle`                                                                                                                                                                                                                          |
diff --git a/doc/cupertino-getting-started.md b/doc/cupertino-getting-started.md
@@ -8,7 +8,10 @@ uid: Uno.Themes.Cupertino.GetStarted
   <img src="assets/cupertino-design-system.png" alt="Cupertino design system" />
 </p>
 
-Uno Cupertino is an add-on package that lets you apply [Cupertino - Human Interface Guideline styling](https://developer.apple.com/design/human-interface-guidelines) to your application with a few lines of code.
+> [!IMPORTANT]
+> UnoFeatures: **Cupertino** — add `<UnoFeatures>Cupertino</UnoFeatures>` to your app's `.csproj` to enable Uno Cupertino.
+
+Uno Cupertino is enabled through the `Cupertino` UnoFeatures and lets you apply [Cupertino - Human Interface Guideline styling](https://developer.apple.com/design/human-interface-guidelines) to your application with a few lines of code.
 
 ## Getting Started
 
@@ -60,6 +63,9 @@ Depending on the type of project template that the Uno Platform application was
 
 #### [**Multi-Head Project Template (Legacy)**](#tab/multihead)
 
+> [!NOTE]
+> Use this only when working on older multi-head templates that do not support `UnoFeatures`. Modern templates should use the Single Project instructions above.
+
 1. In the Solution Explorer panel, right-click on your app's **App Code Library** project (`PROJECT_NAME.csproj`) and select `Manage NuGet Packages...`
 1. Install the [`Uno.Cupertino.WinUI`](https://www.nuget.org/packages/Uno.Cupertino.WinUI)
 1. Add the following Cupertino resources to `AppResources.xaml`:
@@ -78,6 +84,9 @@ Depending on the type of project template that the Uno Platform application was
 
 #### [**Shared Project (.shproj) Template (Legacy)**](#tab/shproj)
 
+> [!NOTE]
+> Use this only when working on older `.shproj`-based solutions that do not support `UnoFeatures`. Modern templates should use the Single Project instructions above.
+
 1. In the Solution Explorer panel, right-click on your solution name and select `Manage NuGet Packages for Solution ...`. Choose either:
     - The [`Uno.Cupertino`](https://www.nuget.org/packages/Uno.Cupertino/) package when targetting Xamarin/UWP
     - The [`Uno.Cupertino.WinUI`](https://www.nuget.org/packages/Uno.Cupertino.WinUI) package when targetting net6.0+/WinUI
diff --git a/doc/lightweight-styling.md b/doc/lightweight-styling.md
@@ -4,6 +4,9 @@ uid: Uno.Themes.LightweightStyling
 
 # Lightweight Styling
 
+> [!IMPORTANT]
+> UnoFeatures: **Material** — add `<UnoFeatures>Material</UnoFeatures>` to your app's `.csproj` to include the Uno Material resources used in these examples.
+
 [Lightweight styling](https://learn.microsoft.com/windows/apps/design/style/xaml-styles#lightweight-styling) is a way to customize the appearance of XAML controls by **overriding** their default brushes, fonts, and numeric properties. Lightweight styles are changed by providing alternate resources with the same key. All Uno Material styles support the capability to be customized through resource overrides without the need to redefine the style.
 
 Overriding resources from Uno Material can be done at the App level, Page level, or even at the Control level. The following sections will cover how to override resources at each of these levels.
diff --git a/doc/material-colors.md b/doc/material-colors.md
@@ -4,6 +4,9 @@ uid: Uno.Themes.Material.Colors
 
 # Material Colors and Brushes
 
+> [!IMPORTANT]
+> UnoFeatures: **Material** — add `<UnoFeatures>Material</UnoFeatures>` to your app's `.csproj` to include Uno Material resources.
+
 ## Colors
 
 | Key                          | LightValue | DarkValue |
diff --git a/doc/material-controls-styles.md b/doc/material-controls-styles.md
@@ -4,6 +4,9 @@ uid: Uno.Themes.Material.Styles
 
 # Material Controls Styles
 
+> [!IMPORTANT]
+> UnoFeatures: **Material** — add `<UnoFeatures>Material</UnoFeatures>` to your app's `.csproj` to include Uno Material resources.
+
 | Control                   | Style Key                       | IsDefaultStyle\* |
 |---------------------------|---------------------------------|------------------|
 | `AppBarButton`            | `AppBarButtonStyle`             | True             |
diff --git a/doc/material-dsp.md b/doc/material-dsp.md
@@ -4,6 +4,9 @@ uid: Uno.Themes.Material.DSP
 
 # Using the DSP Tooling in Uno.Material
 
+> [!IMPORTANT]
+> UnoFeatures: **Material** and **Dsp** — add `<UnoFeatures>Material; Dsp;</UnoFeatures>` to your app's `.csproj` to include Uno Material and Dsp resources.
+
 ## Introduction
 
 Is it possible to automate the creation of the Material Design color palette? Yes, it is. Uno.Material provides a tooling to generate the color palette from the official Material Design color palette. This tooling is available in the [Uno.Dsp.Cli](https://nuget.org/packages/Uno.Dsp.Cli) and [Uno.Dsp.Tasks](https://nuget.org/packages/Uno.Dsp.Tasks) NuGet packages. The following instructions will cover the Uno.Dsp.Tasks version, which is more automatic.
diff --git a/doc/material-getting-started.md b/doc/material-getting-started.md
@@ -8,7 +8,10 @@ uid: Uno.Themes.Material.GetStarted
   <img src="assets/material-design-system.png" alt="Material design system" />
 </p>
 
-The Uno Material library is available as NuGet packages that can be added to any new or existing Uno Platform solution.
+> [!IMPORTANT]
+> UnoFeatures: **Material** — add `<UnoFeatures>Material</UnoFeatures>` to your app's `.csproj` to add Uno Material.
+
+The Uno Material library is enabled through the `Material` UnoFeatures, which brings in the required packages for new and existing Uno Platform solutions.
 Uno Material lets you apply [Material Design 3](https://m3.material.io/) styling to your application with just a few lines of code.
 
 > [!WARNING]
@@ -91,6 +94,9 @@ Depending on the type of project template that the Uno Platform application was
 
 #### [**Multi-Head Project Template (Legacy)**](#tab/multihead)
 
+> [!NOTE]
+> Use this only when working on older multi-head templates that do not support `UnoFeatures`. Modern templates should use the Single Project instructions above.
+
 1. In the Solution Explorer panel, right-click on your app's **App Code Library** project (`PROJECT_NAME.csproj`) and select `Manage NuGet Packages...`
 2. Install the [`Uno.Material.WinUI`](https://www.nuget.org/packages/Uno.Material.WinUI)
 3. Add the following Material resources to `AppResources.xaml`:
@@ -108,9 +114,12 @@ Depending on the type of project template that the Uno Platform application was
 
 #### [**Shared Project (.shproj) Template (Legacy)**](#tab/shproj)
 
+> [!NOTE]
+> Use this only when working on older `.shproj`-based solutions that do not support `UnoFeatures`. Modern templates should use the Single Project instructions above.
+
 1. In the Solution Explorer panel, right-click on your solution name and select `Manage NuGet Packages for Solution ...`. Choose either:
-     - The [`Uno.Material`](https://www.nuget.org/packages/Uno.Material/) package when targetting Xamarin/UWP
-     - The [`Uno.Material.WinUI`](https://www.nuget.org/packages/Uno.Material.WinUI) package when targetting net6.0+/WinUI
+    - The [`Uno.Material`](https://www.nuget.org/packages/Uno.Material/) package when targetting Xamarin/UWP
+    - The [`Uno.Material.WinUI`](https://www.nuget.org/packages/Uno.Material.WinUI) package when targetting net6.0+/WinUI
 
 2. Select the following projects for installation:
     - `PROJECT_NAME.Wasm.csproj`
diff --git a/doc/material-migration.md b/doc/material-migration.md
@@ -4,6 +4,9 @@ uid: Uno.Themes.Material.Migration
 
 # Upgrading Uno Material
 
+> [!IMPORTANT]
+> UnoFeatures: **Material** — add `<UnoFeatures>Material</UnoFeatures>` to your app's `.csproj` to include Uno Material resources.
+
 ## Upgrading to Uno Themes v5
 
 The Uno Material v5 packages introduce a new dependency on the [Uno Themes](https://www.nuget.org/packages/Uno.Themes.WinUI) package. Uno Themes is the base library for all design system implementations going forward. As a result, the following changes have been made:
diff --git a/doc/themes-control-extensions.md b/doc/themes-control-extensions.md
@@ -4,6 +4,9 @@ uid: Uno.Themes.Control.Extensions
 
 # Control Extensions
 
+> [!IMPORTANT]
+> UnoFeatures: **Material** — add `<UnoFeatures>Material</UnoFeatures>` to your app's `.csproj` to include the Uno Material resources referenced in these samples.
+
 ## Icon
 
 This feature allows for the addition of icon on the supported controls. Those icons could be any of the [`IconElement`](https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.iconelement)s: `<BitmapIcon />`, `<FontIcon />`, `<PathIcon />`, or `<SymbolIcon />`.
diff --git a/doc/themes-overview.md b/doc/themes-overview.md
@@ -8,6 +8,9 @@ uid: Uno.Themes.Overview
   <img src="assets/themes-design-systems.png" alt="Themes design systems" />
 </p>
 
+> [!IMPORTANT]
+> UnoFeatures: **Material** or **Cupertino** — enable these themes by adding `<UnoFeatures>Material</UnoFeatures>` or `<UnoFeatures>Cupertino</UnoFeatures>` to your app's `.csproj`.
+
 ## Summary
 
 - [Material Overview](material-getting-started.md)
@@ -16,7 +19,7 @@ uid: Uno.Themes.Overview
 
 ## Uno Themes Styles
 
-[Uno Themes](https://github.com/unoplatform/Uno.Themes) is the repository for add-ons NuGet packages that can be added to any new or existing Uno solution.
+[Uno Themes](https://github.com/unoplatform/Uno.Themes) is the repository for add-ons enabled through UnoFeatures that can be added to any new or existing Uno solution.
 
 It contains three libraries:
 
