$npx -y skills add syncfusion/maui-ui-components-skills --skill syncfusion-maui-getting-startedSets up and configures Syncfusion .NET MAUI components. Use when setting up, configuring, installing, or licensing Syncfusion .NET MAUI applications. Covers installation (NuGet, installers), licensing (generation, registration, errors), themes (Material, Cupertino, customization)
| 1 | # Getting Started with Syncfusion .NET MAUI |
| 2 | |
| 3 | A comprehensive guide for installing, configuring, and setting up your development environment for Syncfusion .NET MAUI components |
| 4 | |
| 5 | ## When to Use This Skill |
| 6 | |
| 7 | **ALWAYS use this skill immediately** when the user needs to: |
| 8 | |
| 9 | - **Install or Setup:** NuGet packages, installers (web, offline, Mac), installation troubleshooting |
| 10 | - **License:** Generate license keys, register keys in applications, resolve licensing errors, trial to paid upgrades |
| 11 | - **Theme:** Apply Material/Cupertino themes, light/dark modes, customize theme colors, override theme keys |
| 12 | - **AI Integration:** Configure Azure OpenAI, Claude, Gemini, DeepSeek, Groq, or custom AI services for Smart Components |
| 13 | - **Tooling:** Use Visual Studio or VS Code extensions, project templates, code snippets, Essential UI Kit |
| 14 | - **Advanced:** Implement Liquid Glass UI, upgrade NuGet packages, handle breaking changes |
| 15 | - **Troubleshoot:** Installation errors, licensing issues, theme problems, AI service configuration |
| 16 | |
| 17 | This skill contains cross-cutting concerns that apply to all Syncfusion .NET MAUI components and applications. |
| 18 | |
| 19 | --- |
| 20 | |
| 21 | ## Overview of Syncfusion .NET MAUI |
| 22 | |
| 23 | Syncfusion .NET MAUI (Multi-platform App UI) is a comprehensive collection of high-performance, feature-rich UI components for building native cross-platform applications. Built on Microsoft's .NET MAUI framework, it enables developers to create modern, beautiful applications with a single codebase targeting: |
| 24 | |
| 25 | - **Windows** (desktop applications) |
| 26 | - **macOS** (desktop applications) |
| 27 | - **iOS** (mobile applications) |
| 28 | - **Android** (mobile applications) |
| 29 | |
| 30 | ### Key Capabilities |
| 31 | |
| 32 | - **70+ Components:** Grids, charts, gauges, editors, calendars, schedulers, and more |
| 33 | - **Native Performance:** Platform-specific optimizations for smooth UX |
| 34 | - **Consistent API:** Single codebase works across all platforms |
| 35 | - **Theme Support:** Material Design and Cupertino (iOS-style) themes with light/dark modes |
| 36 | - **AI-Powered:** Smart Components with AI service integration |
| 37 | - **Accessibility:** WCAG-compliant with screen reader support |
| 38 | - **Localization:** RTL and multi-language support |
| 39 | |
| 40 | ### Component Categories |
| 41 | |
| 42 | Syncfusion .NET MAUI includes components across multiple categories: |
| 43 | - Data Visualization (Charts, Gauges, TreeMap) |
| 44 | - Grids & Data (DataGrid, ListView, TreeView) |
| 45 | - Editors & Inputs (TextBox, ComboBox, DatePicker, Autocomplete) |
| 46 | - Calendars & Scheduling (Calendar, Scheduler, DateRangePicker) |
| 47 | - Navigation (TabView, TreeView, Accordion, Carousel) |
| 48 | - Layout (Cards, Chips, Avatar, Backdrop) |
| 49 | - Buttons & Indicators (Button, Checkbox, RadioButton, Badge, Busy Indicator) |
| 50 | - File Formats (PDF, Excel, Word, PowerPoint) |
| 51 | |
| 52 | --- |
| 53 | |
| 54 | ## Platform Support & Requirements |
| 55 | |
| 56 | ### Supported Platforms |
| 57 | |
| 58 | | Platform | Minimum Version | Recommended | |
| 59 | |----------|----------------|-------------| |
| 60 | | **Windows** | Windows 10 version 1809+ | Windows 11 | |
| 61 | | **macOS** | macOS 10.15+ | macOS 12+ | |
| 62 | | **iOS** | iOS 11+ | iOS 15+ | |
| 63 | | **Android** | Android 5.0 (API 21)+ | Android 12+ (API 31+) | |
| 64 | |
| 65 | ### Framework Compatibility |
| 66 | |
| 67 | Syncfusion .NET MAUI supports: |
| 68 | - **.NET 6** (initial MAUI support) |
| 69 | - **.NET 7** (enhanced features) |
| 70 | - **.NET 8** (LTS with full feature set) |
| 71 | - **.NET 9** (latest features) |
| 72 | **.NET 10** (latest features) |
| 73 | |
| 74 | ### Development Environment |
| 75 | |
| 76 | **Windows Development:** |
| 77 | - Visual Studio 2022 (v17.3+) for .NET 9, or Visual Studio 2026 for .NET 10 |
| 78 | - .NET MAUI workload installed |
| 79 | - Android SDK (for Android development) |
| 80 | |
| 81 | **macOS Development:** |
| 82 | - Visual Studio Code with .NET MAUI extension |
| 83 | - Xcode 13+ (for iOS/macOS development) |
| 84 | - .NET MAUI workload installed |
| 85 | |
| 86 | **Cross-Platform:** |
| 87 | - Visual Studio Code with .NET MAUI extension |
| 88 | - .NET SDK 9.0+ (or 10.0+ for .NET 10 features) |
| 89 | |
| 90 | ### System Requirements |
| 91 | |
| 92 | 📄 **For complete system requirements, read:** [references/introduction-overview.md](references/introduction-overview.md) |
| 93 | |
| 94 | --- |
| 95 | |
| 96 | ## Getting Started Guide |
| 97 | |
| 98 | ### Quick Start (3 Steps) |
| 99 | |
| 100 | **Step 1: Install NuGet Package** |
| 101 | |
| 102 | ```bash |
| 103 | dotnet add package Syncfusion.Maui.Core |
| 104 | # Or install specific component packages as needed |
| 105 | ``` |
| 106 | |
| 107 | **Step 2: Register License Key** (Required for v20.2.0.x+) |
| 108 | |
| 109 | In `MauiProgram.cs`, add before `CreateMauiApp()`: |
| 110 | |
| 111 | ```csharp |
| 112 | public static class MauiProgram |
| 113 | { |
| 114 | public static MauiApp CreateMauiApp() |
| 115 | { |
| 116 | // Register Syncfusion license |
| 117 | string licenseKey = Environment.GetEnvironmentVariable("SYNCFUSION_LICENSE_KEY"); |
| 118 | if (!string.IsNullOrEmpty(licenseKey)) |
| 119 | { |
| 120 | Syncfusion.Licensing.SyncfusionLicenseProvid |