bootstrap-postmark

Configure Postmark as the Swoosh mailer adapter for Phoenix 1.8.

1|Updated May 7, 2026
One-click install
npx skills add https://github.com/agoodway/GoodSkills --skill bootstrap-postmark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bootstrap-postmark
Source: https://github.com/agoodway/GoodSkills/tree/main/skills/bootstrap-postmark
Command: npx skills add https://github.com/agoodway/GoodSkills --skill bootstrap-postmark

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the friction of wiring Postmark into a Phoenix 1.8 app’s Swoosh mailer setup by updating the correct config files and environment placeholders safely for production.

Core Features & Use Cases

  • Production Postmark adapter wiring: Configures the Swoosh mailer in production to use Swoosh.Adapters.Postmark backed by POSTMARK_API_KEY.
  • Environment-ready sender configuration: Adds MAILER_FROM_EMAIL (required) and MAILER_FROM_NAME (optional) to .env.sample and maps them into runtime config for the :mailer_from tuple.
  • Phoenix/Swoosh correctness checks: Audits existing Swoosh usage, verifies the mailer module exists (creating it if missing), and ensures dev/test use the correct local/test adapters.
  • Safety-first discovery: Performs a pre-change discovery report and skips steps that are already configured.

Quick Start

Tell the AI to bootstrap Postmark mailer support for your Phoenix 1.8 app by configuring Swoosh production delivery, adding required environment variables to .env.sample, and verifying or creating your Swoosh mailer module.

Frequently Asked Questions about bootstrap-postmark

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Postmark for production email delivery in a Phoenix app?

To configure Postmark for production in Phoenix, set Swoosh.Adapters.Postmark as your production mailer adapter, add POSTMARK_API_KEY and MAILER_FROM_EMAIL to runtime.exs, and generate a use Swoosh.Mailer module if one is missing.

What environment variables do I need for Swoosh Postmark integration in Phoenix?

Swoosh Postmark integration requires POSTMARK_API_KEY and MAILER_FROM_EMAIL in your environment configuration, plus an optional MAILER_FROM_NAME, which are mapped into runtime.exs as the :mailer_from tuple.

Does this Postmark Phoenix setup work with Phoenix 1.8 Swoosh configurations?

Yes, this setup targets Phoenix 1.8 by auditing existing Swoosh usage, verifying mailer module correctness, and ensuring dev and test environments use the proper local and test adapters while production uses Postmark.

Why is my Phoenix mailer not sending emails in production with Postmark?

Your Phoenix mailer may not be sending if runtime.exs lacks POSTMARK_API_KEY, the Swoosh mailer module is missing, or dev/test adapters are incorrectly applied to production instead of Swoosh.Adapters.Postmark.

Can I automate adding Postmark config to .env.sample for a Phoenix project?

Yes, this process automatically adds MAILER_FROM_EMAIL and MAILER_FROM_NAME placeholders to .env.sample and maps them into your Phoenix runtime configuration, skipping any variables that are already present.