🌺 AlohaPDF

Create Beautiful PDFs with Aloha Spirit

A modern, intuitive PDF generator for .NET MAUI with tropical vibes.
Perfect for cross-platform mobile and desktop applications.

Getting Started • Examples • Docs • Contribute

---

✨ Why AlohaPDF?

The Aloha Spirit - Creating PDFs should be welcoming, simple, and joyful. AlohaPDF brings that spirit to .NET MAUI.

• 🌺 Simple & Intuitive - Fluent API that feels natural
• 🎨 Beautiful by Default - Tropical color palette inspired design
• 📱 Mobile-First - Built specifically for .NET MAUI
• ⚡ Lightning Fast - Optimized for mobile performance
• 🆓 100% Open Source - MIT licensed, free forever
• 🌴 Modern Design - Contemporary styling out of the box

🚀 Quick Start

Installation

dotnet add package AlohaPDF

Your First PDF

using AlohaPDF;
using AlohaPDF.Core;

var pdf = new AlohaPdfDocument();

pdf.Initialize(new PdfDocumentOptions 
{
    Title = "Welcome to AlohaPDF",
    Subtitle = "Creating PDFs with Aloha Spirit",
    PageSize = PageSize.A4,  // A4, Letter, Legal, A3, A5, Tabloid, Executive, B4, B5
    Orientation = PageOrientation.Portrait,  // Portrait or Landscape
    Info = new DocumentInfo
    {
        Author = "Your Name",
        CreatedDate = DateTime.Now
        // Displays as simple one-line: "Your Name • Created on Feb 11, 2025"
    }
});

pdf
    .AddSection("Aloha!")
    .AddParagraph("Welcome to the easiest way to create PDFs in .NET MAUI!")
    .AddTable(
        headers: new[] { "Feature", "Status" },
        rows: new[]
        {
            new[] { "Beautiful Design", "✓" },
            new[] { "Easy to Use", "✓" },
            new[] { "Open Source", "✓" }
        },
        headerStyle: TableHeaderStyle.Primary
    );

pdf.Generate("aloha.pdf");

That's it! 🌺 You just created a beautiful PDF.

🎯 Key Features

📄 Rich Content ✅ Sections & Subtitles ✅ Paragraphs with styling ✅ Tables (4 beautiful styles) ✅ Lists (bullet & numbered) ✅ Custom spacing ✅ Lines & dividers	🎨 Tropical Design ✅ Coral, ocean, palm colors ✅ Modern typography ✅ Custom fonts support ✅ SVG/PNG/JPG logos ✅ Zebra-striped tables ✅ Rounded corners
🔄 Smart Layout ✅ Auto page breaks ✅ Text wrapping ✅ Repeating headers ✅ Dynamic spacing ✅ Multi-page support ✅ Mobile-optimized	💻 Developer Joy ✅ Fluent, chainable API ✅ IntelliSense support ✅ XML documentation ✅ Type-safe options ✅ Zero setup ✅ .NET 9 ready

📱 Platform Support

Platform	Status
🍎 iOS	✅ Fully Supported
🤖 Android	✅ Fully Supported
🪟 Windows	✅ Fully Supported
🍎 macOS	✅ Fully Supported

💡 Examples

Tropical Color Tables

// Coral primary header
pdf.AddTable(headers, rows, headerStyle: TableHeaderStyle.Primary);

// Ocean blue accent
pdf.AddTable(headers, rows, headerStyle: TableHeaderStyle.Secondary);

// Dark professional
pdf.AddTable(headers, rows, headerStyle: TableHeaderStyle.Dark);

// Clean minimal
pdf.AddTable(headers, rows, headerStyle: TableHeaderStyle.Minimal);

Custom Fonts

var options = new PdfDocumentOptions
{
    Title = "Custom Font Report",
    Fonts = new FontOptions
    {
        Regular = await FileSystem.OpenAppPackageFileAsync("Fonts/Inter-Regular.ttf"),
        Bold = await FileSystem.OpenAppPackageFileAsync("Fonts/Inter-Bold.ttf")
    }
};

Logos

var options = new PdfDocumentOptions
{
    Title = "Company Report",
    HeaderLogo = await FileSystem.OpenAppPackageFileAsync("Images/logo.svg"),
    FooterLogo = await FileSystem.OpenAppPackageFileAsync("Images/logo-gray.svg")
};

🎨 Color Palette

AlohaPDF uses a tropical-inspired color scheme:

• Primary (Coral): #FF6B35 - Warm and welcoming
• Secondary (Ocean): #00A8CC - Professional and calm
• Accent (Palm): #6BBF59 - Fresh and vibrant

📖 Documentation

Core Methods

Method	Description
Initialize(options)	Set up your PDF
AddSection(text, pill)	Add numbered section
AddSubtitle(text, pill)	Add subtitle
AddParagraph(text, ...)	Add text with wrapping
AddTable(headers, rows, ...)	Add data table
AddList(items, ...)	Add bullet/numbered list
Generate(path)	Create the PDF file

Table Styles

• Primary - Coral header (warm & inviting)
• Secondary - Ocean header (professional)
• Dark - Dark header (elegant)
• Light - Light header (clean)
• Minimal - Bottom border only

🏝️ Real-World Examples

Check out /samples for complete examples:

• Sales Report - Professional business reports
• Invoice - Beautiful invoices
• Meeting Notes - Structured documents
• Product Catalog - Multi-column layouts

🤝 Contributing

Aloha! We welcome contributions with open arms! 🤗

1. 🐛 Report bugs - Help us improve
2. 💡 Suggest features - Share your ideas
3. 📝 Improve docs - Make it easier for others
4. 🔧 Submit PRs - Code with Aloha spirit

See CONTRIBUTING.md for guidelines.

📄 License

MIT License - Copyright (c) 2025 Diego Belapatiño Farias

🙏 Acknowledgments

• Built with SkiaSharp
• SVG support by Svg.Skia
• Inspired by tropical paradise 🏝️

⭐ Show Your Support

If AlohaPDF brings Aloha spirit to your project:

• ⭐ Star this repository
• 🐦 Share on social media
• 📝 Write about it
• 💬 Spread the Aloha!

---

Made with 🌺 Aloha Spirit by Diego Belapatiño Farias

Create PDFs with joy, not frustration 😊

Report Bug • Request Feature • Say Aloha