Aquila.MsgBits 1.1.4

Aquila.MsgBits

🚀 Lightweight Android messaging utility for .NET MAUI

Aquila.MsgBits provides a simple, native, and extensible messaging API for .NET MAUI applications, starting with Android Toast messages and designed to grow into snackbars, alerts, and more.

📘 Overview

Aquila.MsgBits is a developer-friendly utility that helps you display short user messages without writing platform-specific code.

Instead of dealing with Android namespaces, platform checks, or heavy UI plugins, you use one clean API:

MsgBits.Show("Operation successful");

❓ Why Aquila.MsgBits?

In .NET MAUI:

• There is no built-in Toast API
• Developers often repeat Android-specific code
• UI logic gets polluted with platform checks
• Third-party plugins add unnecessary weight

Aquila.MsgBits solves this by providing a single, minimal, native abstraction.

✨ Key Features

• ✅ Native Android Toast messages
• ✅ Single-line API
• ✅ Android-only (safe no-op on other platforms)
• ✅ Zero configuration
• ✅ No external dependencies
• ✅ Clean and extensible design
• ✅ Production-ready

📦 Installation

Using NuGet

dotnet add package Aquila.MsgBits

Or install via Visual Studio → NuGet Package Manager.

🚀 Usage

Basic Message

using Aquila.MsgBits;

MsgBits.Show("Hello from Aquila!");

Long Message

MsgBits.Show("Data saved successfully", MessageLength.Long);

That’s it. No initialization. No platform-specific code.

🔧 Platform Support

You can safely call MsgBits.Show() from shared MAUI code.

🆚 With vs Without Aquila.MsgBits

❌ Without Aquila.MsgBits

#if ANDROID
Android.Widget.Toast.MakeText(
    Android.App.Application.Context,
    "Hello",
    Android.Widget.ToastLength.Short
).Show();
#endif

Problems:

• Platform checks everywhere
• Repeated boilerplate
• Harder maintenance
• Poor scalability

✅ With Aquila.MsgBits

MsgBits.Show("Hello");

Benefits:

• Clean shared code
• Better readability
• Easier refactoring
• Future-ready API

🧠 Design Philosophy

• One entry point (MsgBits)
• Platform logic hidden internally
• Extensible architecture
• Minimal surface area
• No magic, no heavy abstractions

This allows future additions like:

MsgBits.Snackbar("No internet");
MsgBits.Alert("Delete item?");

Without breaking existing code.

🛣 Roadmap

Planned enhancements:

• Snackbar support (Android)
• Toast queue handling
• Theme-aware messages
• Network-aware messaging
• Unified Aquila.Maui.Toolkit

👨‍💻 Maintained By

Aquila Innovations 🌐 https://aquilainnovations.in 📧 support@aquilainnovations.in

📄 License

MIT License © Aquila Innovations

⭐ Final Note

Aquila.MsgBits is intentionally small.

It does one thing today — and it does it well.

If you value clean APIs, native behavior, and scalable design, this library is built for you.