How to Use IronPrint with Google Antigravity

/plan Add an /Arrivals page to the FrontDesk .NET 9 MVC site.
Each row's Print registration card button prints that card from the server with IronPrint.

Set up the project first:

- Add the IronPrint package, version 2026.10.1. Its namespace is IronPrint.
- Target net9.0-windows.

The page works like this:

- It lists today's guests from App_Data/arrivals.csv.
- Each card is App_Data/cards/<ReservationId>.pdf.
- The Print action awaits Printer.PrintAsync, never Wait or Result.
- Cards print on A5, two copies, grayscale, with PaperOrientation.Automatic.
- Check the printer name in Printing:PrinterName against Printer.GetPrinterNames before any job.
- Refuse a missing card, or a file that doesn't start with %PDF-, before IronPrint opens it.
- Each click shows its outcome on the page.
- Add the page to the nav bar.

Every printer here opens a Save As dialog. Send no real job.
With Printing:DryRunFolder set, write each job to a JSON file there.
The file holds the reservation, card path, printer and every setting.
appsettings.Development.json already sets the folder.

At startup, set IronPrint.License.LicenseKey once from IRONPRINT_LICENSE_KEY.
The app reads the variable itself, so you never need the value.
Check only that it's set and its length.
Don't print, log or save the key, or list the environment variables.

Answer three questions in the Implementation Plan:

- What does IronPrint do with a printer name it can't find?
- How does the name check compare names?
- What does the page show when IronPrint throws?

Stop when dotnet build reports zero errors.

/plan Add an /Arrivals page to the FrontDesk .NET 9 MVC site.
Each row's Print registration card button prints that card from the server with IronPrint.

Set up the project first:

- Add the IronPrint package, version 2026.10.1. Its namespace is IronPrint.
- Target net9.0-windows.

The page works like this:

- It lists today's guests from App_Data/arrivals.csv.
- Each card is App_Data/cards/<ReservationId>.pdf.
- The Print action awaits Printer.PrintAsync, never Wait or Result.
- Cards print on A5, two copies, grayscale, with PaperOrientation.Automatic.
- Check the printer name in Printing:PrinterName against Printer.GetPrinterNames before any job.
- Refuse a missing card, or a file that doesn't start with %PDF-, before IronPrint opens it.
- Each click shows its outcome on the page.
- Add the page to the nav bar.

Every printer here opens a Save As dialog. Send no real job.
With Printing:DryRunFolder set, write each job to a JSON file there.
The file holds the reservation, card path, printer and every setting.
appsettings.Development.json already sets the folder.

At startup, set IronPrint.License.LicenseKey once from IRONPRINT_LICENSE_KEY.
The app reads the variable itself, so you never need the value.
Check only that it's set and its length.
Don't print, log or save the key, or list the environment variables.

Answer three questions in the Implementation Plan:

- What does IronPrint do with a printer name it can't find?
- How does the name check compare names?
- What does the page show when IronPrint throws?

Stop when dotnet build reports zero errors.

/browser Start the site in the background with dotnet run and go to /Arrivals.
The http profile serves it on http://localhost:5318.

Click Print registration card on every row, top to bottom:

1. Click the button.
2. Wait for the outcome message.
3. Take a screenshot.

TestData/expected-jobs.csv says what each click should produce.
A row marked job should leave one new JSON file in print-jobs.
A row marked refused should leave no file, and the page should say why.

Sum up the clicks in a Walkthrough table with these columns:

- reservation
- expected outcome
- message on the page
- job file written
- paper size, orientation, copies and grayscale from that file
- pass or fail

Before you touch the code, find the log line or exception behind each failed row.
Write it under the table, or say nothing was logged.
Fix the cause, restart the site and click every row again.
Stop that dotnet process by its PID at the end.

/browser Start the site in the background with dotnet run and go to /Arrivals.
The http profile serves it on http://localhost:5318.

Click Print registration card on every row, top to bottom:

1. Click the button.
2. Wait for the outcome message.
3. Take a screenshot.

TestData/expected-jobs.csv says what each click should produce.
A row marked job should leave one new JSON file in print-jobs.
A row marked refused should leave no file, and the page should say why.

Sum up the clicks in a Walkthrough table with these columns:

- reservation
- expected outcome
- message on the page
- job file written
- paper size, orientation, copies and grayscale from that file
- pass or fail

Before you touch the code, find the log line or exception behind each failed row.
Write it under the table, or say nothing was logged.
Fix the cause, restart the site and click every row again.
Stop that dotnet process by its PID at the end.

Which IronPrint version does FrontDesk.csproj reference? Quote the PackageReference line.
Then tell me where the code applies the key.
Read the code for this, and don't start the app.

Check the project against these rules for the key:

- It reaches the app only through IRONPRINT_LICENSE_KEY at startup.
- No appsettings file has an IronPrint.LicenseKey entry.
- Properties/launchSettings.json holds no key.
- With the variable missing, startup writes a single warning naming the variable, with no value.

Change Program.cs only if that warning isn't there.
Don't edit anything else.

Which IronPrint version does FrontDesk.csproj reference? Quote the PackageReference line.
Then tell me where the code applies the key.
Read the code for this, and don't start the app.

Check the project against these rules for the key:

- It reaches the app only through IRONPRINT_LICENSE_KEY at startup.
- No appsettings file has an IronPrint.LicenseKey entry.
- Properties/launchSettings.json holds no key.
- With the variable missing, startup writes a single warning naming the variable, with no value.

Change Program.cs only if that warning isn't there.
Don't edit anything else.

/learn Write the decisions of this session to a new AGENTS.md in the repository root.
Use the heading "Front desk printing" and cover:

- the target framework IronPrint needs here
- how the printer name is checked, and why
- the settings every registration card prints with
- the dry-run folder, and that no real job goes out from this machine
- where IRONPRINT_LICENSE_KEY comes from, and that it never goes into a file
- that a change is finished only when every row of TestData/expected-jobs.csv passes in /browser

Tell me the rules before you save them.

/learn Write the decisions of this session to a new AGENTS.md in the repository root.
Use the heading "Front desk printing" and cover:

- the target framework IronPrint needs here
- how the printer name is checked, and why
- the settings every registration card prints with
- the dry-run folder, and that no real job goes out from this machine
- where IRONPRINT_LICENSE_KEY comes from, and that it never goes into a file
- that a change is finished only when every row of TestData/expected-jobs.csv passes in /browser

Tell me the rules before you save them.

/plan Show me the Implementation Plan Artifact and wait for my go-ahead before editing.

Move the printing code out of the controller into Services/CardPrinter.cs.
Register it with dependency injection.

Here's how CardPrinter behaves:

- BuildSettings returns the PrintSettings for a card, so tests can read them without printing.
- A printer name passes only on an exact match with Printer.GetPrinterNames, case included.
- A missing card, a non-PDF file or an unknown printer comes back as a refusal with a reason.
- IronPrint's LicensingException isn't public, so match it by type name.
- That exception becomes a message saying the key is missing.
- With Printing:DryRunFolder set, it still writes the JSON job file and sends nothing.

Then add a Print all cards button to /Arrivals.
The new button works this way:

- It puts one job per arrival on a Channel that a BackgroundService reads.
- Jobs run one at a time.
- The request returns straight away.
- The page lists each job as queued, done or refused.

Finish with the /browser table again, then click Print all cards and add its rows.
Wait until no job shows as queued before that last screenshot.

/plan Show me the Implementation Plan Artifact and wait for my go-ahead before editing.

Move the printing code out of the controller into Services/CardPrinter.cs.
Register it with dependency injection.

Here's how CardPrinter behaves:

- BuildSettings returns the PrintSettings for a card, so tests can read them without printing.
- A printer name passes only on an exact match with Printer.GetPrinterNames, case included.
- A missing card, a non-PDF file or an unknown printer comes back as a refusal with a reason.
- IronPrint's LicensingException isn't public, so match it by type name.
- That exception becomes a message saying the key is missing.
- With Printing:DryRunFolder set, it still writes the JSON job file and sends nothing.

Then add a Print all cards button to /Arrivals.
The new button works this way:

- It puts one job per arrival on a Channel that a BackgroundService reads.
- Jobs run one at a time.
- The request returns straight away.
- The page lists each job as queued, done or refused.

Finish with the /browser table again, then click Print all cards and add its rows.
Wait until no job shows as queued before that last screenshot.

using IronPrint;

public sealed record PrintOutcome(bool Printed, string Message);

public sealed class CardPrinter(IConfiguration config, IWebHostEnvironment env)
{
    public static PrintSettings BuildSettings(string printerName) => new()
    {
        PrinterName = printerName,
        PaperSize = PaperSize.A5,
        PaperOrientation = PaperOrientation.Automatic,
        NumberOfCopies = 2,
        Grayscale = true,
    };

    public async Task<PrintOutcome> PrintCardAsync(string reservationId)
    {
        string card = Path.Combine(env.ContentRootPath, "App_Data", "cards", reservationId + ".pdf");
        if (!File.Exists(card))
            return new(false, $"No registration card for reservation {reservationId}.");

        var header = new byte[5];
        using (var stream = File.OpenRead(card))
            stream.ReadExactly(header);
        if (System.Text.Encoding.ASCII.GetString(header) != "%PDF-")
            return new(false, $"Card {reservationId} is not a PDF.");

        // IronPrint sends a job for an unknown name to the Windows default printer, so match the name here.
        string printer = config["Printing:PrinterName"] ?? "";
        List<string> installed = await Printer.GetPrinterNamesAsync();
        if (!installed.Contains(printer, StringComparer.Ordinal))
            return new(false, $"Printer '{printer}' is not installed on this server.");

        try
        {
            await Printer.PrintAsync(card, BuildSettings(printer));
            return new(true, $"Card {reservationId} sent to {printer}.");
        }
        catch (Exception ex) when (ex.GetType().Name == "LicensingException")
        {
            return new(false, "IronPrint has no license key. Set IRONPRINT_LICENSE_KEY on the server.");
        }
    }
}

using IronPrint;

public sealed record PrintOutcome(bool Printed, string Message);

public sealed class CardPrinter(IConfiguration config, IWebHostEnvironment env)
{
    public static PrintSettings BuildSettings(string printerName) => new()
    {
        PrinterName = printerName,
        PaperSize = PaperSize.A5,
        PaperOrientation = PaperOrientation.Automatic,
        NumberOfCopies = 2,
        Grayscale = true,
    };

    public async Task<PrintOutcome> PrintCardAsync(string reservationId)
    {
        string card = Path.Combine(env.ContentRootPath, "App_Data", "cards", reservationId + ".pdf");
        if (!File.Exists(card))
            return new(false, $"No registration card for reservation {reservationId}.");

        var header = new byte[5];
        using (var stream = File.OpenRead(card))
            stream.ReadExactly(header);
        if (System.Text.Encoding.ASCII.GetString(header) != "%PDF-")
            return new(false, $"Card {reservationId} is not a PDF.");

        // IronPrint sends a job for an unknown name to the Windows default printer, so match the name here.
        string printer = config["Printing:PrinterName"] ?? "";
        List<string> installed = await Printer.GetPrinterNamesAsync();
        if (!installed.Contains(printer, StringComparer.Ordinal))
            return new(false, $"Printer '{printer}' is not installed on this server.");

        try
        {
            await Printer.PrintAsync(card, BuildSettings(printer));
            return new(true, $"Card {reservationId} sent to {printer}.");
        }
        catch (Exception ex) when (ex.GetType().Name == "LicensingException")
        {
            return new(false, "IronPrint has no license key. Set IRONPRINT_LICENSE_KEY on the server.");
        }
    }
}

Agent A: create an xUnit project called FrontDesk.Tests on net9.0-windows, like the web project.
Its tests cover CardPrinter and never send a job:

1. For each job row in TestData/expected-jobs.csv, check the settings BuildSettings returns.
2. Check that reservations 1045 and 1047 are refused, and why.
3. Check that "adobe pdf" in lower case is refused as a printer name.

FrontDesk.csproj is in the repository root, so exclude FrontDesk.Tests from its compile items.
Run them with dotnet test FrontDesk.Tests.

Agent B: wait for Agent A's tests to pass on the current code.
Then use /browser to click every Print button and Print all cards.
Add one screenshot per click to the Walkthrough, and mention there that the tests ran first.

Agent A: create an xUnit project called FrontDesk.Tests on net9.0-windows, like the web project.
Its tests cover CardPrinter and never send a job:

1. For each job row in TestData/expected-jobs.csv, check the settings BuildSettings returns.
2. Check that reservations 1045 and 1047 are refused, and why.
3. Check that "adobe pdf" in lower case is refused as a printer name.

FrontDesk.csproj is in the repository root, so exclude FrontDesk.Tests from its compile items.
Run them with dotnet test FrontDesk.Tests.

Agent B: wait for Agent A's tests to pass on the current code.
Then use /browser to click every Print button and Print all cards.
Add one screenshot per click to the Walkthrough, and mention there that the tests ran first.

This app will run under IIS on a Windows Server 2022 machine at the front desk.
Leave the C# alone.
IIS isn't installed here, so publish only.

Do these in order:

1. Run dotnet publish -c Release -r win-x64 --self-contained false -o out/iis.
2. List every native DLL in out/iis with the NuGet package that brought it in.
3. Confirm that web.config in out/iis carries no license key.

Then tell me where IIS should set IRONPRINT_LICENSE_KEY for this app.

This app will run under IIS on a Windows Server 2022 machine at the front desk.
Leave the C# alone.
IIS isn't installed here, so publish only.

Do these in order:

1. Run dotnet publish -c Release -r win-x64 --self-contained false -o out/iis.
2. List every native DLL in out/iis with the NuGet package that brought it in.
3. Confirm that web.config in out/iis carries no license key.

Then tell me where IIS should set IRONPRINT_LICENSE_KEY for this app.