# Postboi

> Postboi is A framework-agnostic email library optimised for SvelteKit. One API, swappable providers, zero configuration — turn FormData into tidy HTML emails.

LLM-friendly Markdown for every page is available at `/raw/<slug>`; this is the source content without navigation chrome.
Use `/sitemap.xml` for URL discovery and `/robots.txt` for crawl guidance.

## Docs

- [Introduction](https://postboi.uilo.co/raw/index): Postboi is a framework-agnostic email library optimised for SvelteKit — one API, swappable providers, zero configuration.
- [Quick start](https://postboi.uilo.co/raw/quick-start): postboi init picks a provider, collects credentials, writes your env vars, and installs Postboi.
- [Manual setup](https://postboi.uilo.co/raw/manual-setup): Skip the CLI and wire Postboi up by hand — install, set a provider, and send.
- [SvelteKit form actions](https://postboi.uilo.co/raw/sveltekit): Wire a contact form to Postboi with a one-line SvelteKit action.
- [FormData](https://postboi.uilo.co/raw/formdata): How Postboi turns submitted FormData into tidy, sectioned HTML email tables.
- [Providers](https://postboi.uilo.co/raw/providers): Every supported email provider, its import path, and constructor options.
- [Global settings](https://postboi.uilo.co/raw/settings): Set hooks, defaults, and behaviour once with postboi.settings.ts — applied to every send.
- [Hooks](https://postboi.uilo.co/raw/hooks): Run awaitable callbacks around every send — observe, rewrite, cancel, and report.
- [Errors & retries](https://postboi.uilo.co/raw/errors): One normalised PostboiError across every provider, plus opt-in retries.
- [Bulk sending](https://postboi.uilo.co/raw/bulk): Pass an array to send() for bounded-concurrency bulk sends that never throw.
- [API reference](https://postboi.uilo.co/raw/api): The provider surface, SendOptions, the Email type, and common constructor options.

## Optional

- [GitHub](https://github.com/darbymanning/postboi): Source code, issues, and discussions.
- [Package](https://www.npmjs.com/package/postboi): Installation and release metadata.