Agile.Maui.Gallery 1.0.2

<div align="center">

Agile.Maui

<img src="agile.png" alt="Agile.Maui" width="160" />

Native, modular components for .NET MAUI

ImageView / GalleryView | PdfViewer / PdfReaderView | VirtualizedCollectionView | ChipGroup | SignaturePad

Overview | Features | Projects | Platforms | Documentation

</div>

A .NET MAUI component library with native implementations for Android, iOS, macOS Catalyst, and Windows. The current solution is modular: each component lives in its own project/package, but they all share the C# namespace Agile.Maui.

Overview

Agile.Maui is a collection of native MAUI controls for common mobile and desktop app scenarios: zoomable images, galleries, PDF reading, virtualized lists, chip-based selections, and signature capture. Each module can be installed separately, so the app consumes only what it uses.

Why use it

• Native controls per platform; the PDF viewer does not rely on WebView and images use native views.
• Independent packages sharing the same C# namespace.
• Bindable APIs for XAML and MVVM.
• Platform-specific handlers for Android, iOS, macOS Catalyst, and Windows.
• Sample app and per-component documentation.

Features

Requirements

• .NET MAUI / .NET 10.0.
• Android, iOS, macOS Catalyst, or Windows.
• Registration of the package used in MauiProgram.cs.

Projects

Controls_old is a legacy copy of the old monolithic project and is not part of the active solution.

Installation

Install only the packages your application actually uses:

dotnet add package Agile.Maui.Gallery
dotnet add package Agile.Maui.Pdf
dotnet add package Agile.Maui.VirtualizedCollection
dotnet add package Agile.Maui.ChipGroup
dotnet add package Agile.Maui.SignaturePad

Then register the handlers in MauiProgram.cs:

using Agile.Maui;

builder
    .UseMauiApp<App>()
    .UseAgileGalleryView()
    .UseAgilePdfViewer()
    .UseAgileVirtualizedCollectionView()
    .UseAgileChipGroup()
    .UseAgileSignaturePad();

Each method is independent. If the application uses only PDF, for example, call only UseAgilePdfViewer().

XAML

The C# namespace is the same, but the XAML assembly changes per package:

xmlns:gallery="clr-namespace:Agile.Maui;assembly=Agile.Maui.Gallery"
xmlns:pdf="clr-namespace:Agile.Maui;assembly=Agile.Maui.Pdf"
xmlns:virtualized="clr-namespace:Agile.Maui;assembly=Agile.Maui.VirtualizedCollection"
xmlns:chips="clr-namespace:Agile.Maui;assembly=Agile.Maui.ChipGroup"
xmlns:signature="clr-namespace:Agile.Maui;assembly=Agile.Maui.SignaturePad"

Example:

<gallery:ImageView Source="photo" />
<gallery:GalleryView Images="{Binding Photos}" />
<pdf:PdfViewer Source="{Binding PdfPath}" />
<pdf:PdfReaderView Source="manual.pdf" />
<virtualized:VirtualizedCollectionView ItemsSource="{Binding Items}" />
<chips:ChipGroup ItemsSource="{Binding Categories}" LayoutMode="Horizontal" />
<signature:SignaturePad StrokeColor="#111111" />

Platforms

Performance

• VirtualizedCollectionView uses native handlers and virtualization to reduce cost on large lists.
• PdfViewer renders pages on demand and provides a configurable cache/prefetch.
• GalleryView and ImageView use native per-platform loading and cache where applicable.
• SignaturePad stores strokes as vector data and exports images on demand.

Troubleshooting

• If a control does not render, confirm that the corresponding UseAgile...() method was called.
• If XAML cannot find the control, check the assembly in the namespace, such as Agile.Maui.Pdf, Agile.Maui.Gallery, Agile.Maui.VirtualizedCollection, Agile.Maui.ChipGroup, or Agile.Maui.SignaturePad.
• For bundled PDFs, use MauiAsset and refer to docs/PDFViewer.md.

Structure

Agile.Maui.slnx
GalleryView/
PDFViewer/
VirtualizedCollectionView/
ChipGroup/
SignaturePad/
sample/
docs/
TUNING.md
PROFILING.md

Build

dotnet build
dotnet build -f net10.0-android
dotnet build -f net10.0-ios
dotnet build -f net10.0-maccatalyst
dotnet build -f net10.0-windows10.0.19041.0

Additional documentation

• GalleryView and ImageView
• PDFViewer and PdfReaderView
• VirtualizedCollectionView
• ChipGroup
• SignaturePad
• Sample application
• Performance tuning
• Android profiling of VirtualizedCollectionView

License

Distributed under the MIT license.

Support

Use the repository issue tracker to report bugs, ask questions, or suggest new features.