syncfusion-maui-cards

$npx mdskill add syncfusion/maui-ui-components-skills/syncfusion-maui-cards

Create dismissible card views and swipeable card stacks in .NET MAUI.

  • Build interactive card UIs with swipe and dismiss gestures.
  • Depends on Syncfusion .NET MAUI Cards (SfCards) NuGet package.
  • Selects card type and customization based on user requirements.
  • Provides XAML code, C# snippets, and event handling examples.

SKILL.md

.github/skills/syncfusion-maui-cardsView on GitHub ↗
---
name: syncfusion-maui-cards
description: Implements Syncfusion .NET MAUI Cards (SfCards) - dismissible card views and swipeable card stacks. Use when working with cards, card views, card layouts, swipeable cards, dismissible cards, or card stacks in .NET MAUI. Covers card customization, card events, card data binding, and interactive card components with swipe functionality.
metadata:
  author: "Syncfusion Inc"
  version: "34.1.29"
---

# Implementing .NET MAUI Cards (SfCards)

The Syncfusion .NET MAUI Cards control, which provides both dismissible single card views (`SfCardView`) and swipeable card stacks (`SfCardLayout`). This skill covers installation, card creation, swipe gestures, customization, data binding, events, and modern visual effects.

## When to Use This Skill

Use this skill when the user needs to:

- **Create dismissible card views** - Single cards that can be swiped away (left/right)
- **Build card stacks** - Multiple stacked cards with swipe navigation
- **Implement swipe gestures** - Cards that respond to swipe in four directions (left, right, top, bottom)
- **Display card-based UI** - Visual card containers for content organization
- **Add interactive cards** - Cards with tap events, dismiss events, and state management
- **Bind data to cards** - Dynamically generate cards from data collections using BindableLayout
- **Customize card appearance** - Borders, corners, indicators, colors, and glass effects
- **Handle card events** - Tapped, dismissing, dismissed, index changing events

This skill is specifically for Syncfusion's .NET MAUI Cards control (SfCardView and SfCardLayout), not generic card layouts or other card libraries.

## Component Overview

The Syncfusion .NET MAUI Cards control provides two main components:

1. **SfCardView** - A single card that can optionally be dismissed by swiping
2. **SfCardLayout** - A container for stacking multiple SfCardView items with swipe navigation

**Key Capabilities:**
- Swipe-to-dismiss functionality
- Multi-directional swipe support (left, right, top, bottom)
- Visual customization (borders, corners, indicators)
- Programmatic card dismissal
- Data binding with BindableLayout
- Comprehensive event handling
- Modern liquid glass effect (.NET 10+)

## Documentation and Navigation Guide

### Getting Started
📄 **Read:** [references/getting-started.md](references/getting-started.md)

Read this reference when the user needs to:
- Install the Syncfusion.Maui.Cards NuGet package
- Register Syncfusion handlers in MauiProgram.cs
- Create their first SfCardView
- Understand basic XAML and C# implementation patterns

### Card View Features
📄 **Read:** [references/card-views.md](references/card-views.md)

Read this reference when the user works with single cards and needs:
- SfCardView component overview and usage
- SwipeToDismiss property for swipe-away functionality
- IsDismissed property for programmatic dismissal
- FadeOutOnSwiping visual effect
- Single card implementation patterns
- Standalone card scenarios

### Card Layout Features
📄 **Read:** [references/card-layouts.md](references/card-layouts.md)

Read this reference when the user needs card stacks with:
- SfCardLayout component (multiple stacked cards)
- ShowSwipedCard property for edge display
- VisibleIndex property for card navigation
- SwipeDirection configuration (Left, Right, Top, Bottom)
- Multiple card management
- Swipe gesture navigation between cards

### Customization and Styling
📄 **Read:** [references/customization.md](references/customization.md)

Read this reference when the user wants to customize:
- BorderColor, BorderWidth, CornerRadius properties
- Background colors and gradients
- Indicator customization (color, thickness, position)
- FadeOutOnSwiping effect
- Advanced visual styling
- Custom card designs and themes

### Data Binding with BindableLayout
📄 **Read:** [references/data-binding.md](references/data-binding.md)

Read this reference when the user needs to:
- Generate cards dynamically from data collections
- Use BindableLayout with SfCardLayout
- Set up ViewModels and data sources
- Configure ItemsSource and ItemTemplate
- Create data-driven card interfaces
- Bind card properties to data models

### Events and Interactions
📄 **Read:** [references/events.md](references/events.md)

Read this reference when the user needs to handle:
- Tapped event (card tap detection)
- VisibleIndexChanging event (before card changes, with Cancel support)
- VisibleIndexChanged event (after card changes)
- Dismissing event (before dismiss, with Cancel support)
- Dismissed event (after dismiss completes)
- Event handler implementation and scenarios

### Liquid Glass Effect
📄 **Read:** [references/liquid-glass-effect.md](references/liquid-glass-effect.md)

Read this reference when the user wants:
- Modern translucent glass effect
- EnableLiquidGlassEffect property usage
- Platform requirements (macOS 26+, iOS 26+, .NET 10)
- Background configuration for glass appearance
- Sleek, modern card designs

More from syncfusion/maui-ui-components-skills

SkillDescription
syncfusion-maui-accordionImplements Syncfusion .NET MAUI Accordion (SfAccordion) - a vertically collapsible panel with stacked headers for expanding/collapsing content. Use when working with accordions, collapsible panels, expandable lists, employee lists with details, or FAQ sections in .NET MAUI applications. Covers AccordionItem configuration, expand modes, and grouped content display.
syncfusion-maui-ai-assistviewImplements Syncfusion .NET MAUI AI AssistView (SfAIAssistView) for AI-powered interactive chat interfaces. Use when working with AI chat interfaces, AI AssistView, SfAIAssistView, conversational UI, or chat with AI responses. Covers integrating AI services, creating chat UIs, implementing conversation flows, managing AI requests/responses, and displaying AI suggestions.
syncfusion-maui-autocompleteImplements and configure Syncfusion .NET MAUI Autocomplete (SfAutocomplete) control for intelligent text input with suggestions. Use when implementing autocomplete, autosuggest, type-ahead search, smart search, or filtered dropdowns in .NET MAUI applications. Covers data binding, filtering modes, custom search logic, AI-powered search, multi-selection with tokens, and UI customization.
syncfusion-maui-avatar-viewImplements Syncfusion .NET MAUI Avatar View (SfAvatarView) for displaying user profile pictures, initials, or group avatars. Use when working with avatar views, profile pictures, user images, initials display, profile icons, or contact images. Ideal for implementing user profile displays, contact lists, chat interfaces, or social feeds.
syncfusion-maui-backdropImplements Syncfusion .NET MAUI Backdrop Page (SfBackdropPage) with back layer and front layer surfaces. Use when working with backdrop pages, SfBackdropPage, back layer, front layer, or reveal/conceal animations. Covers backdrop navigation patterns, header icons, corner shapes, reveal height, layer state events, and liquid glass effect.
syncfusion-maui-badge-viewImplements Syncfusion .NET MAUI Badge View (SfBadgeView) control. Use when adding badge notifications, status indicators, unread counts, or notification overlays to MAUI applications. Covers SfBadgeView setup, badge text customization, position adjustments, animations, predefined symbols, and accessibility features.
syncfusion-maui-barcode-generatorImplements Syncfusion .NET MAUI Barcode Generator (SfBarcodeGenerator) for generating machine-readable barcodes. Use when working with barcodes, barcode generation, QR codes, data matrix, EAN codes, UPC codes, Code128, or Code39. This skill covers both one-dimensional (linear) and two-dimensional (matrix) barcode symbologies with extensive customization options.
syncfusion-maui-busy-indicatorImplements Syncfusion .NET MAUI Busy Indicator (SfBusyIndicator) for showing loading states, data processing, and app activity indicators. Use when displaying loading indicators, busy animations, activity spinners, or processing feedback in .NET MAUI apps. Covers busy indicator setup, animations, and visual feedback during long-running operations.
syncfusion-maui-buttonImplements and customize Syncfusion .NET MAUI Button (SfButton) control. Use when working with MAUI buttons, SfButton implementation, button customization, or visual states. Covers button icons, background images, RTL support, Liquid Glass effects, custom button views, button styling, events, and checkable buttons.
syncfusion-maui-calendarImplements and customize Syncfusion .NET MAUI Calendar (SfCalendar) control. Use when implementing calendar functionality, date selection (single, multiple, range), or calendar views (month, year, decade, century). Covers date restrictions (min/max dates, EnablePastDates, SelectableDayPredicate), calendar customization, events (ViewChanged, SelectionChanged, Tapped), and header/footer customization.