Harara.Pdf 1.0.1

Harara.Pdf

A C# library for PDF generation — a faithful and idiomatic port of the popular Dart PDF library.
Designed for .NET developers who need to generate PDF documents programmatically with fine-grained control over layout, text, images, shapes, and more — using a powerful widget-based system similar to Flutter.

✨ Features

• Create multi-page PDF documents
• Powerful Widget system for flexible layout composition
• Text styling, wrapping, alignment, and rich layout
• Draw shapes, images, lines, Tables, Charts and more
• Shadow generation and styling
• Supports RTL languges

📦 Installation

dotnet add package Harara.Pdf

🛠️ Usage

using Harara.Pdf.ImageSharp;
using Harara.Pdf.Pdf;
using Harara.Pdf.Widgets;

PdfOptions.SetImageDecoder(new ImageSharpDecoder());
var pdf = new Document();
pdf.AddPage(new Page(
    build: context =>
        new Center(
            child: new Column(
                children: [
                    new Text("Welcome", style: new TextStyle(fontSize:30)),
                    new Text("Thank you for using Harara.Pdf")
                ]
            )
        )
));
var bytes = await pdf.SaveAsync();
File.WriteAllBytes("output.pdf", bytes);

🧩 Custom Widgets with StatelessWidget

You can extend the PDF widget system by creating your own widgets using StatelessWidget:

using Harara.Pdf.ImageSharp;
using Harara.Pdf.Pdf;
using Harara.Pdf.Widgets;

PdfOptions.SetImageDecoder(new ImageSharpDecoder());
var pdf = new Document();
pdf.AddPage(new Page(
    build: context => new Custom()
));
var bytes = await pdf.SaveAsync();
File.WriteAllBytes("output.pdf", bytes);

class Custom : StatelessWidget
{
    public override Widget Build(Context context)
    {
        return new Center(
            child: new Column(
                children:
                [
                    new Text("Welcome", style: new TextStyle(fontSize: 30)),
                    new Text("Thank you for using Harara.Pdf")
                ]
            )
        );
    }
}


This allows you to encapsulate and reuse PDF widget logic just like you would in a Flutter or Dart `pdf` project.

⚠️ Image Decoder Required

You must include one of the following image decoder packages to enable image support:

• Harara.Pdf.ImageSharp
• Harara.Pdf.NetVips
• Harara.Pdf.SkiaSharp

Alternatively, you can create your own custom image decoder by implementing the required IImageDecoder interface and registering it with the library.

📋 License

MIT License © Ahmed Harara
This project is inspired by the Dart pdf package.

🙋‍♂️ Contributions

Pull requests, issues, and ideas are always welcome.
Please open an issue to discuss major changes before submitting a PR.