reputecast

module
v1.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 24, 2026 License: AGPL-3.0

README

Open-source, self-hosted newsletters that reach the inbox.
Send through your own Amazon SES, Postmark, Mailgun, SendGrid, Resend, Postal or any SMTP server.

CI Latest release

Quick start · Self-hosting · API · Contributing · Releases

ReputeCast is a newsletter and email-marketing platform you run yourself. It sends through the providers you already use, checks every campaign for deliverability problems before it goes out, and pauses a send when bounces or complaints climb. Every feature is free: there is no paid edition and no seat or workspace limit.

Features

  • Send Readiness. Every campaign gets a verdict before it goes out (Ready, Ready with warnings or Blocked), with evidence and a fix for each finding: blocklists, SPF/DKIM/DMARC, content, links, Gmail and Yahoo bulk-sender rules, audience quality and routing.
  • Guarded sending. Live progress per mailbox provider and per sending provider. The whole send, or just one route, pauses when bounces or complaints cross your thresholds.
  • Bring your own providers. Amazon SES, Mailgun, SendGrid, Postmark, Resend, SparkPost, Mailjet, Brevo, Azure Communication Services, Postal and any SMTP server, several at once: routing per stream and mailbox provider, weighted splits, failover, warm-up and one shared suppression list. Or write an adapter.
  • Composer. A drag-and-drop MJML builder with Liquid personalization, a code view, device and inbox previews, A/B variants and inline deliverability warnings.
  • Honest analytics. Human opens counted apart from machine opens (Apple Mail Privacy Protection), a click map, and results per mailbox provider and per sending provider.
  • Audience and automations. Contacts, segments (builder or read-only SQL), engagement tiers and a sunset policy; visual automation flows with live stats.
  • Forms and public pages. Signup forms with double opt-in, a preference center, one-click unsubscribe and a public archive.
  • Deliverability. Domain and IP health, provider account health, blocklists and DMARC. Connect HostRepute to add 80+ blocklists, Google Postmaster Tools and Microsoft SNDS.
  • Teams and access. Roles with granular permissions, send approvals, passkeys and TOTP, OIDC single sign-on and an immutable audit log.
  • Imports that keep consent from Brevo, Mailchimp, MailerLite, listmonk, Keila, CSV or XLSX.
  • API, webhooks and MCP. A REST API described by OpenAPI 3.1, signed webhooks, and an MCP server for AI agents that pass the same permission checks as people.

Screenshots

Send Readiness checks reputation, authentication, content and routing before you send. Live monitor with results per mailbox provider and auto-pause thresholds.
Composer that flags deliverability problems while you write. Reports that count human and machine opens apart.
Routing across providers, with weighted splits, failover and a route tester. Automations as visual flows with live stats on every step.
More screenshots

Deliverability: health per sending domain and IP, and each provider's account health.

Sending providers: health, quotas, costs and what each provider supports.

Segments: AND/OR condition groups with a live count.

Quick start

You need Docker with Compose:

curl -fsSL -o docker-compose.yml \
  https://raw.githubusercontent.com/hostrepute/reputecast/main/deploy/docker-compose.yml
REPUTECAST_ADMIN_EMAIL=you@example.com docker compose up -d
docker compose logs app | grep -A4 "ReputeCast is installed"

Open http://localhost:8080 and sign in with the temporary password from the logs. ReputeCast then walks you through securing your account and connecting a sending provider.

For a server with a domain and TLS, or to run the release binary, follow the self-hosting guide. To explore the Acme demo data from a checkout, see CONTRIBUTING.md.

Documentation

Contributing

Issues, discussions and pull requests are welcome. CONTRIBUTING.md explains how to set up the development environment and what a change needs. Please follow the Code of Conduct, and report security problems privately as described in SECURITY.md.

License

ReputeCast is licensed under the GNU Affero General Public License v3.0. It is built by HostRepute and works with or without a HostRepute account.

Directories

Path Synopsis
cmd
reputecast command
Command reputecast is the single ReputeCast binary: the web app and API, background workers, webhook ingest, installation and maintenance commands.
Command reputecast is the single ReputeCast binary: the web app and API, background workers, webhook ingest, installation and maintenance commands.
internal
access
Package access holds the presentation side of authorization shared by the team, roles, API key and MCP screens: the permission catalogue as the API returns it, scope labels ("Beta Program list only"), sign-in method and two-factor labels, and the "who can help" helper names.
Package access holds the presentation side of authorization shared by the team, roles, API key and MCP screens: the permission catalogue as the API returns it, scope labels ("Beta Program list only"), sign-in method and two-factor labels, and the "who can help" helper names.
accessrequests
Package accessrequests backs the "Request Editor access" action on the 403 screen: it names the smallest built-in role that grants a missing permission and sends the request to the members who manage the team.
Package accessrequests backs the "Request Editor access" action on the 403 screen: it names the smallest built-in role that grants a missing permission and sends the request to the members who manage the team.
accounts
Package accounts implements sign-in (identifier first, password, passkeys, two-factor, recovery codes), sessions, password resets, accepting invitations, the signed-in person's profile and security settings, and the first sign-in setup of an instance.
Package accounts implements sign-in (identifier first, password, passkeys, two-factor, recovery codes), sessions, password resets, accepting invitations, the signed-in person's profile and security settings, and the first sign-in setup of an instance.
api
Package api holds the Huma (OpenAPI 3.1) setup shared by every domain: operation helpers that declare the required permission, the middleware that authenticates users, API keys and MCP agents and authorizes them with internal/authz, and RFC 9457 error helpers.
Package api holds the Huma (OpenAPI 3.1) setup shared by every domain: operation helpers that declare the required permission, the middleware that authenticates users, API keys and MCP agents and authorizes them with internal/authz, and RFC 9457 error helpers.
apikeys
Package apikeys manages API keys and MCP agents (A5 §3.9, §5.13).
Package apikeys manages API keys and MCP agents (A5 §3.9, §5.13).
app
Package app wires configuration, the database, background jobs, the HTTP API and every domain package into one runnable process.
Package app wires configuration, the database, background jobs, the HTTP API and every domain package into one runnable process.
approvals
Package approvals implements send approvals (add-on 3.8, 5.12) and the Review & send flow around them (spec 7.5): the workspace policy and its rules, approval requests with a snapshot of what they cover (content and subject, audience definition, route, schedule), invalidation with the exact diff when any of it changes or the audience moves more than 10%, comments, decisions, the send-time recheck, the Owners' emergency bypass, and scheduling or starting the send through the sending engine.
Package approvals implements send approvals (add-on 3.8, 5.12) and the Review & send flow around them (spec 7.5): the workspace policy and its rules, approval requests with a snapshot of what they cover (content and subject, audience definition, route, schedule), invalidation with the exact diff when any of it changes or the audience moves more than 10%, comments, decisions, the send-time recheck, the Owners' emergency bypass, and scheduling or starting the send through the sending engine.
apptest
Package apptest runs the whole HTTP stack against a fresh test database so API behaviour can be tested end to end: middleware, authz, handlers, SQL.
Package apptest runs the whole HTTP stack against a fresh test database so API behaviour can be tested end to end: middleware, authz, handlers, SQL.
audience
Package audience implements the Audience screens (spec 5.6, 7.9): contacts with saved views and bulk actions, contact profiles with consent history and an activity timeline, lists and custom fields, engagement tiers and the sunset policy, list health, audited CSV export and the shared suppression list.
Package audience implements the Audience screens (spec 5.6, 7.9): contacts with saved views and bulk actions, contact profiles with consent history and an activity timeline, lists and custom fields, engagement tiers and the sunset policy, list health, audited CSV export and the shared suppression list.
audit
Package audit writes the immutable audit log: who did what to which target, before and after, from where, and whether it was allowed.
Package audit writes the immutable audit log: who did what to which target, before and after, from where, and whether it was allowed.
auditlog
Package auditlog serves the audit log (A5 §3.10, §5.14): filtered event list, event detail with before/after values, streamed CSV/JSON exports, streaming to a webhook and retention.
Package auditlog serves the audit log (A5 §3.10, §5.14): filtered event list, event detail with before/after values, streamed CSV/JSON exports, streaming to a webhook and retention.
authn
Package authn implements sign-in primitives: argon2id password hashing, opaque session and API tokens (only SHA-256 hashes are stored), TOTP, recovery codes, the optional breached-password check, passkeys and OIDC.
Package authn implements sign-in primitives: argon2id password hashing, opaque session and API tokens (only SHA-256 hashes are stored), TOTP, recovery codes, the optional breached-password check, passkeys and OIDC.
authz
Package authz is ReputeCast's small, in-house authorization layer.
Package authz is ReputeCast's small, in-house authorization layer.
automations
Package automations implements visual flows (spec 7.10): the React Flow graph and its validation, versions with a diff and publish, the runs engine on River and per-step stats.
Package automations implements visual flows (spec 7.10): the React Flow graph and its validation, versions with a diff and publish, the runs engine on River and per-step stats.
campaigns
Package campaigns implements campaigns: the list and summary, drafts and the composer's storage, versions, scheduling and sending state.
Package campaigns implements campaigns: the list and summary, drafts and the composer's storage, versions, scheduling and sending state.
cli
Package cli implements the reputecast command line with cobra.
Package cli implements the reputecast command line with cobra.
config
Package config loads ReputeCast configuration from defaults, an optional YAML file, REPUTECAST_* environment variables and command-line flags, in that order of precedence (later wins).
Package config loads ReputeCast configuration from defaults, an optional YAML file, REPUTECAST_* environment variables and command-line flags, in that order of precedence (later wins).
connect
Package connect implements "Connect a sending provider" (spec 5.7, 7.2): the provider catalog built from the adapter registry, and a six-step setup (provider, connection, domain verification, test send, streams, contacts) whose progress is kept in provider_setups so a reload resumes the same step.
Package connect implements "Connect a sending provider" (spec 5.7, 7.2): the provider catalog built from the adapter registry, and a six-step setup (provider, connection, domain verification, test send, streams, contacts) whose progress is kept in provider_setups so a reload resumes the same step.
contentcheck
Package contentcheck finds deliverability problems in an email's content: size against Gmail's 102 KB clipping limit, images without alt text, the image-to-text ratio, links on URI blocklists, URL shorteners and broken links, a missing unsubscribe link or postal address, Liquid errors, spam heuristics in the subject, and the plain-text part.
Package contentcheck finds deliverability problems in an email's content: size against Gmail's 102 KB clipping limit, images without alt text, the image-to-text ratio, links on URI blocklists, URL shorteners and broken links, a missing unsubscribe link or postal address, Liquid errors, spam heuristics in the subject, and the plain-text part.
db
Package db opens the Postgres pool and runs schema migrations (goose for ReputeCast's own tables, rivermigrate for River's job tables).
Package db opens the Postgres pool and runs schema migrations (goose for ReputeCast's own tables, rivermigrate for River's job tables).
deliverability
Package deliverability builds the Deliverability screen (spec 7.8): health per sending domain and dedicated IP (shared pools are checked at domain level), provider account health against each provider's own thresholds, blocklists (via HostRepute when connected, else a built-in DNSBL set), Postmaster Tools, SNDS, DMARC reports and the incident timeline.
Package deliverability builds the Deliverability screen (spec 7.8): health per sending domain and dedicated IP (shared pools are checked at domain level), provider account health against each provider's own thresholds, blocklists (via HostRepute when connected, else a built-in DNSBL set), Postmaster Tools, SNDS, DMARC reports and the incident timeline.
demo
Package demo loads the sample data from the design ("Acme Newsletter") so the app can be explored, screenshotted and compared with the prototype.
Package demo loads the sample data from the design ("Acme Newsletter") so the app can be explored, screenshotted and compared with the prototype.
dnscheck
Package dnscheck answers the DNS questions deliverability depends on: SPF, DKIM, DMARC (with policy discovery), BIMI and MAIL FROM alignment for sending domains, forward-confirmed reverse DNS for IPs, and DNSBL listings for both.
Package dnscheck answers the DNS questions deliverability depends on: SPF, DKIM, DMARC (with policy discovery), BIMI and MAIL FROM alignment for sending domains, forward-confirmed reverse DNS for IPs, and DNSBL listings for both.
domains
Package domains implements sending domains and sender identities (spec 7.13 Settings › Senders, and the domain step of 7.2): the DNS records each sending provider needs (through the provider's domain API when it has one), live verification with internal/dnscheck, the authentication summary per domain, verification per sender and sending provider, the default sender of each stream, custom link-tracking domains, adding records through the Cloudflare API, and a periodic re-verification job.
Package domains implements sending domains and sender identities (spec 7.13 Settings › Senders, and the domain step of 7.2): the DNS records each sending provider needs (through the provider's domain API when it has one), live verification with internal/dnscheck, the authentication summary per domain, verification per sender and sending provider, the default sender of each stream, custom link-tracking domains, adding records through the Cloudflare API, and a periodic re-verification job.
emailaddr
Package emailaddr checks and classifies email addresses for the audience and the importer: syntax, role addresses, disposable domains, likely typos, spam-trap-like patterns, mailbox providers and masking.
Package emailaddr checks and classifies email addresses for the audience and the importer: syntax, role addresses, disposable domains, likely typos, spam-trap-like patterns, mailbox providers and masking.
forms
Package forms implements signup forms and the settings of the public pages (spec 5.12, 7.12): embedded, popup and hosted forms, the embed script, spam protection, the submission pipeline the public pages call, double opt-in emails on the System stream, and the pages' branding, custom domain and Turnstile keys.
Package forms implements signup forms and the settings of the public pages (spec 5.12, 7.12): embedded, popup and hosted forms, the embed script, spam protection, the submission pipeline the public pages call, double opt-in emails on the System stream, and the pages' branding, custom domain and Turnstile keys.
hostrepute
Package hostrepute connects a workspace to HostRepute (hostrepute.com), the sibling email-reputation service: OAuth 2 (PKCE) or API-key connection, encrypted tokens, a River job that syncs blocklist, Postmaster, SNDS, DMARC and alert data, "Add to monitoring" and disconnect.
Package hostrepute connects a workspace to HostRepute (hostrepute.com), the sibling email-reputation service: OAuth 2 (PKCE) or API-key connection, encrypted tokens, a River job that syncs blocklist, Postmaster, SNDS, DMARC and alert data, "Add to monitoring" and disconnect.
hostrepute/hrtest
Package hrtest is a fake HostRepute (API and OAuth server) for tests.
Package hrtest is a fake HostRepute (API and OAuth server) for tests.
imports
Package imports is the migration importer (spec 5.8, 7.11): CSV and XLSX uploads and API importers for Brevo, Mailchimp, MailerLite, listmonk and Keila.
Package imports is the migration importer (spec 5.8, 7.11): CSV and XLSX uploads and API importers for Brevo, Mailchimp, MailerLite, listmonk and Keila.
ingest
Package ingest receives provider events: the webhook endpoint (POST /hooks/{adapter}/{token}) verifies the signature, stores the raw payload and answers immediately; a River job normalizes it later.
Package ingest receives provider events: the webhook endpoint (POST /hooks/{adapter}/{token}) verifies the signature, stores the raw payload and answers immediately; a River job normalizes it later.
instance
Package instance is the Instance admin area (add-on spec 3.3, 3.13, 5.10): accounts across workspaces, workspaces (with a 7-day restore hold), the authentication policy, instance settings and version & updates.
Package instance is the Instance admin area (add-on spec 3.3, 3.13, 5.10): accounts across workspaces, workspaces (with a 7-day restore hold), the authentication policy, instance settings and version & updates.
jobs
Package jobs wires River, the Postgres-backed job queue.
Package jobs wires River, the Postgres-backed job queue.
linktoken
Package linktoken signs the tokens embedded in emails: open pixel, click redirect, one-click unsubscribe (RFC 8058), preference center, view online and double opt-in confirmation links.
Package linktoken signs the tokens embedded in emails: open pixel, click redirect, one-click unsubscribe (RFC 8058), preference center, view online and double opt-in confirmation links.
liquid
Package liquid renders personalization in subjects, preheaders and email bodies with Liquid (osteele/liquid): {{ first_name | default: "there" }}.
Package liquid renders personalization in subjects, preheaders and email bodies with Liquid (osteele/liquid): {{ first_name | default: "there" }}.
logging
Package logging configures log/slog for the process.
Package logging configures log/slog for the process.
mailer
Package mailer sends ReputeCast's own system mail (password resets, team invites, double opt-in, approval notifications) through whichever sending provider is routed to the System stream.
Package mailer sends ReputeCast's own system mail (password resets, team invites, double opt-in, approval notifications) through whichever sending provider is routed to the System stream.
maintenance
Package maintenance runs housekeeping jobs: expired sessions and sign-in challenges, audit-log retention, and lists deleted longer ago than they can be restored.
Package maintenance runs housekeeping jobs: expired sessions and sign-in challenges, audit-log retention, and lists deleted longer ago than they can be restored.
mcpserver
Package mcpserver is ReputeCast's Model Context Protocol server (main spec 5.13, A5 §5.13).
Package mcpserver is ReputeCast's Model Context Protocol server (main spec 5.13, A5 §5.13).
media
Package media is the workspace image library used by the composer's asset manager.
Package media is the workspace image library used by the composer's asset manager.
meta
Package meta serves instance information the web app needs before sign-in: the instance name and logo, which sign-in methods are enabled and the version.
Package meta serves instance information the web app needs before sign-in: the instance name and logo, which sign-in methods are enabled and the version.
mjml
Package mjml works with MJML documents on the server: a tolerant parser for outlines, warnings and wireframes, the server-side compiler (gomjml, MJML 4.15) used when content arrives as MJML only (API and automation sends), and head helpers that keep <mj-title>/<mj-preview> in step with the subject and preheader.
Package mjml works with MJML documents on the server: a tolerant parser for outlines, warnings and wireframes, the server-side compiler (gomjml, MJML 4.15) used when content arrives as MJML only (API and automation sends), and head helpers that keep <mj-title>/<mj-preview> in step with the subject and preheader.
netguard
Package netguard makes outbound HTTP requests to user-supplied URLs (outgoing webhooks, the audit stream) safe from server-side request forgery: the address is checked after DNS resolution, at connect time, so a hostname can't point at loopback, private, link-local or metadata addresses, and redirects are never followed.
Package netguard makes outbound HTTP requests to user-supplied URLs (outgoing webhooks, the audit stream) safe from server-side request forgery: the address is checked after DNS resolution, at connect time, so a hostname can't point at loopback, private, link-local or metadata addresses, and redirects are never followed.
notify
Package notify creates in-app notifications (A5 §3.12) and fans them out to the members who should see them.
Package notify creates in-app notifications (A5 §3.12) and fans them out to the members who should see them.
overview
Package overview builds the workspace Overview (spec 7.1): sender health, the next scheduled campaign, provider cards, subscriber growth and tiers, and recent campaigns.
Package overview builds the workspace Overview (spec 7.1): sender health, the next scheduled campaign, provider cards, subscriber growth and tiers, and recent campaigns.
passwordreuse
Package passwordreuse enforces the re-use rule of the instance password policy (Instance admin › Authentication › Password policy): a new password can't be any of the person's last N passwords, the current one included.
Package passwordreuse enforces the re-use rule of the instance password policy (Instance admin › Authentication › Password policy): a new password can't be any of the person's last N passwords, the current one included.
permcheck
Package permcheck checks a second permission inside a handler, for operations whose requirement depends on the request (saving a segment in SQL mode needs segments:sql on top of segments:edit).
Package permcheck checks a second permission inside a handler, for operations whose requirement depends on the request (saving a segment in SQL mode needs segments:sql on top of segments:edit).
providers
Package providers defines the pluggable sending-provider contract.
Package providers defines the pluggable sending-provider contract.
providers/apiclient
Package apiclient is the small JSON-over-HTTP client the API adapters (Postmark, Postal…) share: timeouts, a response size limit, and mapping of HTTP failures to providers.CallError so health checks and the sending pipeline can tell an outage from throttling from rejected credentials.
Package apiclient is the small JSON-over-HTTP client the API adapters (Postmark, Postal…) share: timeouts, a response size limit, and mapping of HTTP failures to providers.CallError so health checks and the sending pipeline can tell an outage from throttling from rejected credentials.
providers/azureacs
Package azureacs is the Azure Communication Services Email adapter, on the data-plane REST API without the Azure SDK.
Package azureacs is the Azure Communication Services Email adapter, on the data-plane REST API without the Azure SDK.
providers/bounce
Package bounce maps SMTP replies and enhanced status codes (RFC 3463) to ReputeCast's shared bounce taxonomy, so every adapter classifies the same diagnostic the same way: mailbox_unknown, mailbox_full, domain_invalid, policy_block, spam_block, reputation, temporary, other.
Package bounce maps SMTP replies and enhanced status codes (RFC 3463) to ReputeCast's shared bounce taxonomy, so every adapter classifies the same diagnostic the same way: mailbox_unknown, mailbox_full, domain_invalid, policy_block, spam_block, reputation, temporary, other.
providers/brevo
Package brevo is the Brevo (formerly Sendinblue) adapter, through the transactional email API v3.
Package brevo is the Brevo (formerly Sendinblue) adapter, through the transactional email API v3.
providers/contracttest
Package contracttest is the shared test suite every sending-provider adapter must pass (TECH_STACK note 10): registration and capabilities, Send (success, permanent rejection, outage, rejected credentials) against a fake of the provider's API, and ParseWebhook (signature verification and normalization) against recorded payloads.
Package contracttest is the shared test suite every sending-provider adapter must pass (TECH_STACK note 10): registration and capabilities, Send (success, permanent rejection, outage, rejected credentials) against a fake of the provider's API, and ParseWebhook (signature verification and normalization) against recorded payloads.
providers/flex
Package flex holds setting types that accept what a connection form may store.
Package flex holds setting types that accept what a connection form may store.
providers/httpgeneric
Package httpgeneric is the generic HTTP adapter (spec 5.2).
Package httpgeneric is the generic HTTP adapter (spec 5.2).
providers/mailgun
Package mailgun is the Mailgun adapter (US and EU regions).
Package mailgun is the Mailgun adapter (US and EU regions).
providers/mailjet
Package mailjet is the Mailjet adapter (Send API v3.1).
Package mailjet is the Mailjet adapter (Send API v3.1).
providers/manage
Package manage is the sending-providers domain: the provider list with health, quota, cost and capabilities (spec 7.3), the health job (outages, rejected credentials, webhooks silent, recovery, failover per stream), provider actions (re-check, credentials, settings, tracking, webhooks, backfill, held broadcasts) and the Adapters tab.
Package manage is the sending-providers domain: the provider list with health, quota, cost and capabilities (spec 7.3), the health job (outages, rejected credentials, webhooks silent, recovery, failover per stream), provider actions (re-check, credentials, settings, tracking, webhooks, backfill, held broadcasts) and the Adapters tab.
providers/mimemsg
Package mimemsg renders a providers.Message as an RFC 5322 message with wneessen/go-mail, so the adapters that send raw MIME (Amazon SES, Postal, SMTP) produce byte-for-byte the same structure: multipart/alternative (text, then HTML), a Message-ID derived from the ReputeCast message id, and every header the sending pipeline set (List-Unsubscribe, Feedback-ID…).
Package mimemsg renders a providers.Message as an RFC 5322 message with wneessen/go-mail, so the adapters that send raw MIME (Amazon SES, Postal, SMTP) produce byte-for-byte the same structure: multipart/alternative (text, then HTML), a Message-ID derived from the ReputeCast message id, and every header the sending pipeline set (List-Unsubscribe, Feedback-ID…).
providers/postal
Package postal is the adapter for a self-hosted Postal server (postalserver.io).
Package postal is the adapter for a self-hosted Postal server (postalserver.io).
providers/postmark
Package postmark is the Postmark adapter.
Package postmark is the Postmark adapter.
providers/remote
Package remote runs community adapters: sending adapters that live in their own process and speak the adapter protocol (docs/adapters.md, "Community adapters"), signed JSON over HTTP(S).
Package remote runs community adapters: sending adapters that live in their own process and speak the adapter protocol (docs/adapters.md, "Community adapters"), signed JSON over HTTP(S).
providers/remote/remotetest
Package remotetest is a fake community adapter process for tests: a small reference implementation of the adapter side of the protocol (docs/adapters.md) in Go.
Package remotetest is a fake community adapter process for tests: a small reference implementation of the adapter side of the protocol (docs/adapters.md) in Go.
providers/resend
Package resend is the Resend adapter (resend.com).
Package resend is the Resend adapter (resend.com).
providers/sendgrid
Package sendgrid is the Twilio SendGrid adapter (v3 API).
Package sendgrid is the Twilio SendGrid adapter (v3 API).
providers/ses
Package ses is the Amazon SES adapter (SES API v2 through aws-sdk-go-v2), with events delivered through SNS.
Package ses is the Amazon SES adapter (SES API v2 through aws-sdk-go-v2), with events delivered through SNS.
providers/simulator
Package simulator is the demo transport: a sending provider that touches no network.
Package simulator is the demo transport: a sending provider that touches no network.
providers/smtp
Package smtp is the generic SMTP adapter (wneessen/go-mail).
Package smtp is the generic SMTP adapter (wneessen/go-mail).
providers/smtp/bouncebox
Package bouncebox reads the bounce mailbox of an SMTP provider over IMAP (github.com/emersion/go-imap/v2, isolated here because it is still in beta) or POP3 (a small client in this package).
Package bouncebox reads the bounce mailbox of an SMTP provider over IMAP (github.com/emersion/go-imap/v2, isolated here because it is still in beta) or POP3 (a small client in this package).
providers/smtp/dsn
Package dsn parses bounce and complaint reports that arrive by email: delivery status notifications (RFC 3464, multipart/report; report-type=delivery-status) and abuse reports (ARF, RFC 5965, report-type=feedback-report).
Package dsn parses bounce and complaint reports that arrive by email: delivery status notifications (RFC 3464, multipart/report; report-type=delivery-status) and abuse reports (ARF, RFC 5965, report-type=feedback-report).
providers/sparkpost
Package sparkpost is the SparkPost adapter (US and EU).
Package sparkpost is the SparkPost adapter (US and EU).
providers/state
Package state describes what ReputeCast stores about a connected provider in the providers table's JSON columns (capability snapshot, health, pricing, limits, provider-side tracking) and the display helpers every screen shares (short names, chart colours).
Package state describes what ReputeCast stores about a connected provider in the providers table's JSON columns (capability snapshot, health, pricing, limits, provider-side tracking) and the display helpers every screen shares (short names, chart colours).
providers/webhookauth
Package webhookauth holds the webhook authentication schemes several sending providers share, so each adapter verifies them the same way: Standard Webhooks (the Svix scheme Resend uses), HMAC signatures over the body, and shared secrets sent as basic auth or in a header.
Package webhookauth holds the webhook authentication schemes several sending providers share, so each adapter verifies them the same way: Standard Webhooks (the Svix scheme Resend uses), HMAC signatures over the body, and shared secrets sent as basic auth or in a header.
publicpages
Package publicpages serves the pages subscribers see (spec 5.12, 7.12), server-rendered with html/template under the layout of internal/publicurl:
Package publicpages serves the pages subscribers see (spec 5.12, 7.12), server-rendered with html/template under the layout of internal/publicurl:
publicurl
Package publicurl builds the absolute URLs that appear in emails and on public pages, so the code that writes them (sending, tracking, forms, reports) and the handlers that serve them agree on one layout:
Package publicurl builds the absolute URLs that appear in emails and on public pages, so the code that writes them (sending, tracking, forms, reports) and the handlers that serve them agree on one layout:
readiness
Package readiness is Send Readiness (spec 5.1, 7.5): every check a campaign must pass before it goes out, each Pass, Warn, Block or Unknown with its evidence and a fix, plus the estimates around the send (final audience, route, cost and duration, throttling per mailbox provider).
Package readiness is Send Readiness (spec 5.1, 7.5): every check a campaign must pass before it goes out, each Pass, Warn, Block or Unknown with its evidence and a fix, plus the estimates around the send (final audience, route, cost and duration, throttling per mailbox provider).
reports
Package reports builds the campaign report (spec 7.7, honest analytics 5.5) from campaign_counters, its exports and read-only report links, whose public page shows the same aggregate numbers and nothing else.
Package reports builds the campaign report (spec 7.7, honest analytics 5.5) from campaign_counters, its exports and read-only report links, whose public page shows the same aggregate numbers and nothing else.
roles
Package roles implements Roles & permissions (A5 §3.6, §5.9): the four read-only built-in roles, custom roles and the impact preview shown before saving.
Package roles implements Roles & permissions (A5 §3.6, §5.9): the four read-only built-in roles, custom roles and the impact preview shown before saving.
routing
Package routing decides which sending provider delivers each email: rules per stream (Broadcasts, Automations, System) with conditions on the list, the sender domain and the recipient's mailbox provider, a deterministic weighted split for migrations and warm-up, a fallback per stream and the failover policy.
Package routing decides which sending provider delivers each email: rules per stream (Broadcasts, Automations, System) with conditions on the list, the sender domain and the recipient's mailbox provider, a deterministic weighted split for migrations and warm-up, a fallback per stream and the failover policy.
secrets
Package secrets encrypts provider credentials, OIDC client secrets, TOTP seeds and other write-only values at rest with AES-256-GCM.
Package secrets encrypts provider credentials, OIDC client secrets, TOTP seeds and other write-only values at rest with AES-256-GCM.
segments
Package segments implements audience segments (spec 5.10, 7.9): a condition builder with AND/OR groups compiled to parameterized SQL, a live count with the tier mix, the generated SQL shown to power users, and SQL mode (segments:sql) where people write read-only SQL over the segment views.
Package segments implements audience segments (spec 5.10, 7.9): a condition builder with AND/OR groups compiled to parameterized SQL, a live count with the tier mix, the generated SQL shown to power users, and SQL mode (segments:sql) where people write read-only SQL over the segment views.
sending
Package sending runs campaign sends: it builds the recipient list, applies suppressions, routes each recipient to a sending provider, throttles per provider and per mailbox provider, sends in batches through River jobs, updates live counters and pauses automatically when thresholds trip.
Package sending runs campaign sends: it builds the recipient list, applies suppressions, routes each recipient to a sending provider, throttles per provider and per mailbox provider, sends in batches through River jobs, updates live counters and pauses automatically when thresholds trip.
sending/engine
Package engine is ReputeCast's sending engine (spec 5.3, 7.6): it builds a campaign's recipient list, routes, renders and hands every message to its sending provider within rate limits and throttles, watches bounce, complaint and outage signals and pauses what they concern, sends automation emails, and serves the live monitor's snapshot and stream.
Package engine is ReputeCast's sending engine (spec 5.3, 7.6): it builds a campaign's recipient list, routes, renders and hands every message to its sending provider within rate limits and throttles, watches bounce, complaint and outage signals and pauses what they concern, sends automation emails, and serves the live monitor's snapshot and stream.
server
Package server builds the HTTP stack: middleware, security headers, the embedded single-page app and graceful shutdown.
Package server builds the HTTP stack: middleware, security headers, the embedded single-page app and graceful shutdown.
sessionext
Package sessionext tells the web app when the current browser session will end and lets the person extend it, so the app can warn before an idle timeout instead of losing unsaved work.
Package sessionext tells the web app when the current browser session will end and lets the person extend it, so the app can warn before an idle timeout instead of losing unsaved work.
sso
Package sso implements single sign-on over OpenID Connect (add-on spec 3.2, 5.11) and social sign-in with Google, Microsoft and GitHub (3.1): provider setup, claim and group mappings, just-in-time accounts, domain enforcement with break-glass Owners, a dry-run test sign-in and the browser flows (state, nonce and PKCE).
Package sso implements single sign-on over OpenID Connect (add-on spec 3.2, 5.11) and social sign-in with Google, Microsoft and GitHub (3.1): provider setup, claim and group mappings, just-in-time accounts, domain enforcement with break-glass Owners, a dry-run test sign-in and the browser flows (state, nonce and PKCE).
sso/ssotest
Package ssotest is a fake OpenID Connect issuer (and a fake GitHub) for tests and local screenshots: discovery, signing keys, an authorization endpoint that approves at once, a token endpoint that checks the client secret and the PKCE verifier and returns a signed ID token with the nonce, and userinfo.
Package ssotest is a fake OpenID Connect issuer (and a fake GitHub) for tests and local screenshots: discovery, signing keys, an authorization endpoint that approves at once, a token endpoint that checks the client secret and the PKCE verifier and returns a signed ID token with the nonce, and userinfo.
sso/ssotest/fakeidp command
Command fakeidp runs the test OpenID Connect issuer locally, so the SSO setup screens can be tried end to end without a real identity provider:
Command fakeidp runs the test OpenID Connect issuer locally, so the SSO setup screens can be tried end to end without a real identity provider:
suppressions
Package suppressions keeps the shared suppression list in sync with each sending provider: addresses suppressed at a provider are pulled into the shared list (a bounce at one provider stops mail everywhere) and the shared list is pushed to providers with a suppression API.
Package suppressions keeps the shared suppression list in sync with each sending provider: addresses suppressed at a provider are pulled into the shared list (a bounce at one provider stops mail everywhere) and the shared list is pushed to providers with a suppression API.
systemmail
Package systemmail sends ReputeCast's own mail (password resets, email changes, team invitations, notifications, double opt-in confirmations, test messages) through the workspace's System-stream route, whose fallback takes over when the provider is down or refuses the message.
Package systemmail sends ReputeCast's own mail (password resets, email changes, team invitations, notifications, double opt-in confirmations, test messages) through the workspace's System-stream route, whose fallback takes over when the provider is down or refuses the message.
team
Package team manages the people of a workspace (A5 §3.5, §5.8): members, invitations, role and scope changes, deactivation and removal.
Package team manages the people of a workspace (A5 §3.5, §5.8): members, invitations, role and scope changes, deactivation and removal.
templates
Package templates holds the composer's template gallery: the starter templates that ship with ReputeCast (MJML files embedded in the binary, their placeholder images served at /media/starters/), the workspace's saved templates and its saved sections (reusable blocks).
Package templates holds the composer's template gallery: the starter templates that ship with ReputeCast (MJML files embedded in the binary, their placeholder images served at /media/starters/), the workspace's saved templates and its saved sections (reusable blocks).
testdb
Package testdb gives integration tests a fresh, migrated Postgres database.
Package testdb gives integration tests a fresh, migrated Postgres database.
tracking
Package tracking serves the open pixel and the click redirect that go in every tracked email, and records opens and clicks honestly: human opens separated from machine opens (Apple Mail Privacy Protection, image proxy prefetches, security scanners) and bot clicks kept out of the counts.
Package tracking serves the open pixel and the click redirect that go in every tracked email, and records opens and clicks honestly: human opens separated from machine opens (Apple Mail Privacy Protection, image proxy prefetches, security scanners) and bot clicks kept out of the counts.
version
Package version exposes build information set by the linker.
Package version exposes build information set by the linker.
warmup
Package warmup plans and runs the warm-up of a new sending provider or dedicated IP: a daily volume ramp, the most engaged contacts first, an automatic slowdown when bounces or complaints rise, and a Broadcast share that grows with the plan (10% → 15% → 25% → 40%).
Package warmup plans and runs the warm-up of a new sending provider or dedicated IP: a daily volume ramp, the most engaged contacts first, an automatic slowdown when bounces or complaints rise, and a Broadcast share that grows with the plan (10% → 15% → 25% → 40%).
webhooks
Package webhooks delivers normalized ReputeCast events to the endpoints a workspace registers (main spec 7.13).
Package webhooks delivers normalized ReputeCast events to the endpoints a workspace registers (main spec 7.13).
workspaces
Package workspaces creates and manages workspaces: built-in roles, the owner membership, settings, transfer of ownership and deletion.
Package workspaces creates and manages workspaces: built-in roles, the owner membership, settings, transfer of ownership and deletion.
Package migrations embeds the goose SQL migrations so the single binary can migrate its own database (`reputecast migrate up`).
Package migrations embeds the goose SQL migrations so the single binary can migrate its own database (`reputecast migrate up`).
sdk
client-go module
Package web embeds the built single-page app (web/dist) into the binary.
Package web embeds the built single-page app (web/dist) into the binary.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL