Skip to content

armgit / posta

Public Imported from GitHub
0

Self-hosted email delivery platform that enables applications to send emails via HTTP APIs while handling SMTP delivery, templates, storage, security, and analytics. Fully self-hostable alternative to services like SendGrid or Mailgun.

chore: update README and About Posta

Jonas Kaninda12d5c0877ad0
diff --git a/README.md b/README.md
index 1840779..8df2317 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
</p>
<p align="center">
- Self-hosted email delivery platform for developers and teams
+ Self-hosted email delivery & inbound platform for developers and teams
</p>
[![CI](https://github.com/goposta/posta/actions/workflows/ci.yml/badge.svg)](https://github.com/goposta/posta/actions/workflows/ci.yml)
@@ -23,12 +23,16 @@
## Overview
-**Posta** is a self-hosted email delivery platform that enables applications to send emails via HTTP APIs while handling SMTP delivery, templates, storage, security, and analytics.
+**Posta** is a self-hosted, developer-first email platform that handles both **outbound** and **inbound** email through a single HTTP API.
-It is designed as a developer-first, fully self-hostable alternative to services like SendGrid or Mailgun.
+- **Outbound** — send transactional and marketing email over your own SMTP, with templates, localization, campaigns, subscriber lists, bounce and complaint handling, and delivery analytics.
+- **Inbound** — receive email at your domains, parse messages and attachments, and forward the structured payloads to your application via webhooks.
+
+It is designed as a fully self-hostable alternative to services like SendGrid, Mailgun, and Postmark — giving you complete ownership of your email infrastructure, data, and deliverability.
[![Website](https://img.shields.io/badge/Website-goposta.dev-blue?style=flat-square)](https://www.goposta.dev/)
[![Try it](https://img.shields.io/badge/Try%20it-app.goposta.dev-green?style=flat-square)](https://app.goposta.dev/)
+[![Source Code](https://img.shields.io/badge/Source%20Code-GitHub-181717?style=flat-square&logo=github)](https://github.com/goposta/posta)
---
## Quick Example
diff --git a/web/src/views/about/About.vue b/web/src/views/about/About.vue
index adc4f35..255ab50 100644
--- a/web/src/views/about/About.vue
+++ b/web/src/views/about/About.vue
@@ -6,15 +6,74 @@ const loading = ref(true)
const appInfo = ref<AppInfo | null>(null)
const links = [
- { title: 'Website', url: 'https://goposta.dev/', icon: 'globe' },
- { title: 'Documentation', url: 'https://docs.goposta.dev/', icon: 'book-open' },
- { title: 'GitHub', url: 'https://github.com/goposta/posta', icon: 'github' },
- { title: 'Go SDK', url: 'https://github.com/goposta/posta-go', icon: 'code' },
- { title: 'PHP SDK', url: 'https://github.com/goposta/posta-php', icon: 'code' },
- { title: 'Java SDK', url: 'https://github.com/goposta/posta-java', icon: 'code' },
+ { title: 'Website', url: 'https://goposta.dev/', mdi: 'mdi-web' },
+ { title: 'Documentation', url: 'https://docs.goposta.dev/', mdi: 'mdi-book-open-page-variant-outline' },
+ { title: 'GitHub', url: 'https://github.com/goposta/posta', mdi: 'mdi-github' },
+ { title: 'Go SDK', url: 'https://github.com/goposta/posta-go', mdi: 'mdi-code-tags' },
+ { title: 'PHP SDK', url: 'https://github.com/goposta/posta-php', mdi: 'mdi-code-tags' },
+ { title: 'Java SDK', url: 'https://github.com/goposta/posta-java', mdi: 'mdi-code-tags' },
+]
+
+// Capability groups — a high-level tour of what Posta does, both outbound and inbound.
+const capabilities = [
+ {
+ icon: 'mdi-send-outline',
+ title: 'Outbound Email',
+ items: [
+ 'REST API for transactional, batch & templated email',
+ 'Attachments, custom headers & scheduled sending',
+ 'Async delivery with automatic retries & priority queues',
+ ],
+ },
+ {
+ icon: 'mdi-inbox-arrow-down-outline',
+ title: 'Inbound Email',
+ items: [
+ 'Built-in SMTP receiver with TLS',
+ 'Webhook ingest with HMAC verification',
+ 'Message, header & attachment storage with forwarding',
+ ],
+ },
+ {
+ icon: 'mdi-file-document-multiple-outline',
+ title: 'Templates & Campaigns',
+ items: [
+ 'Versioned, multi-language templates',
+ 'Bulk campaigns with scheduling & targeting',
+ 'A/B testing with per-variant metrics',
+ ],
+ },
+ {
+ icon: 'mdi-account-group-outline',
+ title: 'Contacts & Subscribers',
+ items: [
+ 'Static & dynamic (segmented) subscriber lists',
+ 'CSV / JSON import with column mapping',
+ 'Bounce & complaint suppression, RFC 8058 unsubscribe',
+ ],
+ },
+ {
+ icon: 'mdi-shield-lock-outline',
+ title: 'Security & Access',
+ items: [
+ 'API keys with hashing, expiry & IP allowlisting',
+ 'JWT auth, RBAC & two-factor (TOTP)',
+ 'OAuth / SSO, rate limiting & session management',
+ ],
+ },
+ {
+ icon: 'mdi-chart-line',
+ title: 'Analytics & Webhooks',
+ items: [
+ 'Open & click tracking with delivery metrics',
+ 'Event-driven webhooks with retries & tracking',
+ 'Prometheus metrics and audit logs',
+ ],
+ },
]
+
onMounted(async () => {
try {
const res = await infoApi.get()
@@ -46,8 +105,8 @@ onMounted(async () => {
<div>
<h2 class="hero-title">Posta</h2>
<p class="hero-description">
- Self-hosted email delivery platform for developers and teams.
- A developer-first, fully self-hostable alternative to services like SendGrid or Mailgun.
+ A self-hosted, developer-first email platform that handles both outbound delivery and
+ inbound receiving through a single HTTP API.
</p>
<div class="hero-meta">
<span v-if="appInfo" class="badge badge-info">
@@ -61,6 +120,24 @@ onMounted(async () => {
</div>
</div>
+ <!-- Capabilities -->
+ <div class="about-section">
+ <h2 class="section-title">Capabilities</h2>
+ <div class="features-grid">
+ <div v-for="cap in capabilities" :key="cap.title" class="card feature-card">
+ <div class="card-body">
+ <h3 class="feature-title">
+ <span class="mdi feature-icon" :class="cap.icon"></span>
+ {{ cap.title }}
+ </h3>
+ <ul class="feature-list">
+ <li v-for="item in cap.items" :key="item">{{ item }}</li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </div>
+
<!-- Links -->
<div class="about-section">
<h2 class="section-title">Resources & SDKs</h2>
@@ -75,7 +152,10 @@ onMounted(async () => {
rel="noopener noreferrer"
class="about-link"
>
- <span class="about-link-title">{{ link.title }}</span>
+ <span class="about-link-left">
+ <span class="mdi about-link-icon" :class="link.mdi"></span>
+ <span class="about-link-title">{{ link.title }}</span>
+ </span>
<svg width="14" height="14" viewBox="0 0 16 16" fill="none">
<path d="M6 3h7v7M13 3L3 13" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
</svg>
@@ -87,6 +167,12 @@ onMounted(async () => {
<!-- Footer -->
<div class="about-footer">
+ <p class="about-powered">
+ Powered by
+ <a href="https://github.com/jkaninda/okapi" target="_blank" rel="noopener noreferrer">
+ <span class="mdi mdi-github"></span> Okapi
+ </a>
+ </p>
<p>&copy; {{ new Date().getFullYear() }} Jonas Kaninda and contributors</p>
</div>
</template>
@@ -153,12 +239,21 @@ onMounted(async () => {
}
.feature-title {
+ display: flex;
+ align-items: center;
+ gap: 8px;
font-size: 15px;
font-weight: 600;
color: var(--text-primary);
margin: 0 0 10px;
}
+.feature-icon {
+ font-size: 18px;
+ color: var(--primary-600, #9333ea);
+ line-height: 1;
+}
+
.feature-list {
margin: 0;
padding: 0 0 0 18px;
@@ -171,35 +266,6 @@ onMounted(async () => {
line-height: 1.7;
}
-.tech-grid {
- display: grid;
- grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
- gap: 12px;
-}
-
-.tech-item {
- display: flex;
- flex-direction: column;
- gap: 2px;
- padding: 12px;
- border-radius: var(--radius-sm, 6px);
- background: var(--bg-secondary);
-}
-
-.tech-category {
- font-size: 11px;
- font-weight: 600;
- text-transform: uppercase;
- letter-spacing: 0.5px;
- color: var(--text-muted);
-}
-
-.tech-name {
- font-size: 14px;
- font-weight: 500;
- color: var(--text-primary);
-}
-
.links-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(180px, 1fr));
@@ -220,11 +286,30 @@ onMounted(async () => {
font-weight: 500;
}
+.about-link-left {
+ display: flex;
+ align-items: center;
+ gap: 10px;
+ min-width: 0;
+}
+
+.about-link-icon {
+ font-size: 18px;
+ color: var(--text-muted);
+ line-height: 1;
+ flex-shrink: 0;
+ transition: color var(--transition, 150ms ease);
+}
+
.about-link:hover {
background: var(--bg-tertiary);
color: var(--primary-600, #9333ea);
}
+.about-link:hover .about-link-icon {
+ color: var(--primary-600, #9333ea);
+}
+
.about-link svg {
color: var(--text-muted);
flex-shrink: 0;
@@ -240,4 +325,24 @@ onMounted(async () => {
color: var(--text-muted);
font-size: 13px;
}
+
+.about-powered {
+ margin-bottom: 4px;
+}
+
+.about-powered a {
+ color: var(--text-secondary);
+ font-weight: 500;
+ text-decoration: none;
+ transition: color var(--transition, 150ms ease);
+}
+
+.about-powered a:hover {
+ color: var(--primary-600, #9333ea);
+}
+
+.about-powered .mdi {
+ font-size: 14px;
+ vertical-align: -1px;
+}
</style>