Aquila.Pop 1.0.6

Absolutely! I can create a comprehensive README for Aquila.Pop that explains how to install, use, and customize your prompts. Here’s a polished version ready for NuGet or GitHub:

Aquila.Pop – Custom MAUI Prompts

Aquila.Pop is a lightweight, customizable prompt library for .NET MAUI. It allows developers to easily show:

1-button prompts

2-button prompts

2-text + 1-button prompts (custom forms)

with overlay, rounded corners, custom colors, and configurable vertical positions.

Features

Fully customizable colors for prompt box and overlay.

Rounded corners (default 25%).

Supports vertical alignment: Start, Center, End.

Async-friendly Show and Hide methods.

Easy integration via NuGet.

Overlay automatically added above page content — no need for AbsoluteLayout hacks.

Installation NuGet Install-Package Aquila.Pop

Local Package

If using a local .nupkg:

Copy Aquila.Pop.nupkg to a folder.

In Visual Studio, go to Manage NuGet Packages → Browse → Local.

Select the package and install.

Initialization

Before showing prompts, initialize PromptService in your page:

using Aquila.Pop.Services;

// Inside your page constructor PromptService.Initialize(this); // 'this' = ContentPage

1. Show a 1-Button Prompt using Aquila.Pop.Controls; using Microsoft.Maui.Graphics;

private async void ShowOneButtonPrompt() { var prompt = new TextButtonPrompt { PromptBackgroundColor = Colors.LightCyan, // prompt box color OverlayColor = Colors.Black.MultiplyAlpha(0.3f), // overlay VerticalPosition = LayoutOptions.Center // Start, Center, End };

prompt.ApplyColors(); // apply custom colors & vertical position

PromptService.ShowPrompt(prompt);

await prompt.Show("Hello World!", "OK", async () =>
{
    Console.WriteLine("OK clicked");
    await prompt.Hide();
    PromptService.HidePrompt(prompt);
});

}

2. Show a 2-Button Prompt private async void ShowTwoButtonPrompt() { var prompt = new TwoButtonPrompt { PromptBackgroundColor = Colors.White, OverlayColor = Colors.Black.MultiplyAlpha(0.3f), VerticalPosition = LayoutOptions.Center };

   prompt.ApplyColors();

   PromptService.ShowPrompt(prompt);

   await prompt.Show( "Do you want to continue?", "Yes", () ⇒ Console.WriteLine("Yes clicked"), "No", () ⇒ Console.WriteLine("No clicked") );

   PromptService.HidePrompt(prompt); }

3. Show a 2-Text + 1-Button Prompt private async void ShowCustomFormPrompt() { var prompt = new TwoTextOneButtonPrompt { PromptBackgroundColor = Colors.LightYellow, OverlayColor = Colors.Black.MultiplyAlpha(0.4f), VerticalPosition = LayoutOptions.Center };

   prompt.ApplyColors(); PromptService.ShowPrompt(prompt);

   await prompt.Show( "Enter Details", "Name", "Email", "Submit", () ⇒ Console.WriteLine("Form submitted") );

   PromptService.HidePrompt(prompt); }

Customization Options Property Description Default PromptBackgroundColor Color of the prompt box White OverlayColor Color of background overlay behind prompt Black 50% VerticalPosition Position of prompt in the screen: Start/Center/End Center CornerRadius Rounded corners of the box (via _frame) 25 WidthRequest Width of the prompt box 300 Notes

Always call PromptService.Initialize(this) once per page.

Call prompt.ApplyColors() if you change PromptBackgroundColor, OverlayColor, or VerticalPosition before showing the prompt.

Multiple prompts can be displayed sequentially; each will overlay on the _overlay grid.

License

Aquila.Pop is free to use in commercial and non-commercial MAUI apps.