> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spurtcommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mail Service

SMTP and transactional email configuration.

The repository `.env.example` documents mail configuration variables including `MAIL_DRIVER`, `MAIL_HOST`, `MAIL_USERNAME`, `MAIL_PASSWORD`, `MAIL_PORT`, `MAIL_SECURE`, and `MAIL_FROM`. It also contains optional AWS SES settings.

## Configuration

Set provider values in the deployment environment. Keep credentials out of source control and use a dedicated SMTP/SES identity. Match the secure transport setting to the provider's documented port and TLS requirements.

## Operational guidance

* Use verified sender identities and authorized recipients where required by the provider.
* Handle provider timeouts and transient failures without blocking critical requests unnecessarily.
* Avoid sending duplicate transactional messages on retries; use event/order idempotency.
* Log delivery metadata and provider error codes, not message secrets or sensitive body content.
* Provide a safe staging/test recipient configuration.

## Source verification

Trace the mail service/provider adapter and call sites to identify templates, supported drivers, queue behavior, and failure handling.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.