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.

feat: add about page

Jonas Kaninda832bd346300c
diff --git a/README.md b/README.md
index ad6eadf..5a8c5cc 100644
--- a/README.md
+++ b/README.md
@@ -86,6 +86,7 @@ Response:
* API keys with expiration, hashing, and IP allowlisting
* JWT authentication and RBAC
* Two-factor authentication (TOTP)
+* OAuth / SSO login (Google, Keycloak, authentik, and more)
* Rate limiting and session management
### Contacts & Suppression
diff --git a/internal/services/seeder/seeder.go b/internal/services/seeder/seeder.go
index 0aa56f1..8918ebb 100644
--- a/internal/services/seeder/seeder.go
+++ b/internal/services/seeder/seeder.go
@@ -81,17 +81,34 @@ func (s *Seeder) SeedUserDefaults(userID uint, userName string) {
"year": time.Now().Year(),
"docs": fmt.Sprintf("%s/docs", goutils.Env("POSTA_WEB_URL", "")),
"features": []string{
- "REST Email API",
- "Versioned templates with localization",
- "Multiple SMTP server management",
+ "REST API for transactional, batch, and templated emails",
+ "Scheduled sending and preview mode",
+ "Async processing with automatic retries and priority queues",
+ "Versioned and multi-language templates with variable substitution",
+ "Multiple SMTP providers with TLS and shared pools",
"Domain verification (SPF, DKIM, DMARC)",
- "Email analytics and event webhooks",
+ "API keys with expiration, hashing, and IP allowlisting",
+ "JWT authentication, RBAC, and two-factor authentication",
+ "Contact tracking, segmentation, and suppression lists",
+ "Multi-tenant workspaces with scoped API keys",
+ "Event-driven webhooks with retry and delivery tracking",
+ "Email delivery analytics and Prometheus metrics",
+ "Web dashboard with dark/light mode",
+ "Official SDKs for Go, PHP, and Java",
},
"links": []map[string]string{
+ {
+ "title": "Website",
+ "url": "https://goposta.dev/",
+ },
{
"title": "API Documentation",
- "url": "/docs",
+ "url": "https://app.goposta.dev/docs",
+ },
+ {
+ "title": "Documentation",
+ "url": "https://docs.goposta.dev/",
},
{
"title": "GitHub Repository",
diff --git a/web/src/layouts/DashboardLayout.vue b/web/src/layouts/DashboardLayout.vue
index d1deedf..4aae26c 100644
--- a/web/src/layouts/DashboardLayout.vue
+++ b/web/src/layouts/DashboardLayout.vue
@@ -74,7 +74,6 @@ const navItems = [
{ name: 'Domains', path: '/domains', icon: 'globe' },
{ name: 'SMTP Servers', path: '/smtp-servers', icon: 'server' },
{ name: 'Settings', path: '/settings', icon: 'settings' },
-
]
const adminItems = [
@@ -86,6 +85,7 @@ const adminItems = [
{ name: 'Events', path: '/admin/events', icon: 'activity' },
{ name: 'OAuth', path: '/admin/oauth', icon: 'key' },
{ name: 'Settings', path: '/admin/settings', icon: 'settings' },
+ { name: 'About', path: '/about', icon: 'info' },
]
function isActive(path: string): boolean {
@@ -295,6 +295,7 @@ function getIcon(name: string): string {
'briefcase': '<svg width="18" height="18" viewBox="0 0 18 18" fill="none"><rect x="2" y="6" width="14" height="10" rx="1.5" stroke="currentColor" stroke-width="1.5"/><path d="M12 6V4.5A1.5 1.5 0 0010.5 3h-3A1.5 1.5 0 006 4.5V6" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>',
'settings': '<svg width="18" height="18" viewBox="0 0 18 18" fill="none"><circle cx="9" cy="9" r="2.25" stroke="currentColor" stroke-width="1.5"/><path d="M14.7 11.1a1.2 1.2 0 00.24 1.32l.04.04a1.46 1.46 0 11-2.06 2.06l-.04-.04a1.2 1.2 0 00-1.32-.24 1.2 1.2 0 00-.73 1.1v.12a1.46 1.46 0 01-2.91 0v-.06a1.2 1.2 0 00-.79-1.1 1.2 1.2 0 00-1.32.24l-.04.04a1.46 1.46 0 11-2.06-2.06l.04-.04a1.2 1.2 0 00.24-1.32 1.2 1.2 0 00-1.1-.73h-.12a1.46 1.46 0 010-2.91h.06a1.2 1.2 0 001.1-.79 1.2 1.2 0 00-.24-1.32l-.04-.04a1.46 1.46 0 112.06-2.06l.04.04a1.2 1.2 0 001.32.24h.06a1.2 1.2 0 00.73-1.1v-.12a1.46 1.46 0 012.91 0v.06a1.2 1.2 0 00.73 1.1 1.2 1.2 0 001.32-.24l.04-.04a1.46 1.46 0 112.06 2.06l-.04.04a1.2 1.2 0 00-.24 1.32v.06a1.2 1.2 0 001.1.73h.12a1.46 1.46 0 010 2.91h-.06a1.2 1.2 0 00-1.1.73z" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>',
'layers': '<svg width="18" height="18" viewBox="0 0 18 18" fill="none"><path d="M9 1.5L1.5 6 9 10.5 16.5 6 9 1.5z" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/><path d="M1.5 12L9 16.5 16.5 12" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/><path d="M1.5 9L9 13.5 16.5 9" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>',
+ 'info': '<svg width="18" height="18" viewBox="0 0 18 18" fill="none"><circle cx="9" cy="9" r="7" stroke="currentColor" stroke-width="1.5"/><path d="M9 12.75V9M9 5.25h.007" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/></svg>',
}
return icons[name] || ''
}
diff --git a/web/src/router/index.ts b/web/src/router/index.ts
index a1bfe8b..2a73147 100644
--- a/web/src/router/index.ts
+++ b/web/src/router/index.ts
@@ -56,6 +56,7 @@ const routes = [
{ path: 'settings', name: 'settings', component: () => import('../views/settings/Settings.vue') },
{ path: 'workspaces', name: 'workspaces', component: () => import('../views/workspaces/Workspaces.vue') },
{ path: 'workspaces/:id', name: 'workspace-detail', component: () => import('../views/workspaces/WorkspaceSettings.vue') },
+ { path: 'about', name: 'about', component: () => import('../views/about/About.vue') },
{ path: 'profile', name: 'profile', component: () => import('../views/auth/Profile.vue') },
{ path: 'change-password', redirect: '/profile' },
// Admin
diff --git a/web/src/views/about/About.vue b/web/src/views/about/About.vue
new file mode 100644
index 0000000..5cfd6b8
--- /dev/null
+++ b/web/src/views/about/About.vue
@@ -0,0 +1,338 @@
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { infoApi, type AppInfo } from '../../api/info'
+
+const loading = ref(true)
+const appInfo = ref<AppInfo | null>(null)
+
+const features = [
+ {
+ title: 'Email Delivery',
+ icon: 'mail',
+ items: [
+ 'REST API for transactional, batch, and templated emails',
+ 'Attachments, custom headers, and unsubscribe support',
+ 'Scheduled sending and preview mode',
+ 'Async processing with Redis and Asynq',
+ 'Automatic retries and priority queues',
+ ],
+ },
+ {
+ title: 'Templates',
+ icon: 'file-text',
+ items: [
+ 'Versioned and multi-language templates',
+ 'Variable substitution and stylesheet inlining',
+ 'Import/export and preview support',
+ ],
+ },
+ {
+ title: 'SMTP & Domains',
+ icon: 'server',
+ items: [
+ 'Multiple SMTP providers with TLS support',
+ 'Shared SMTP pools for teams',
+ 'Domain verification (SPF, DKIM, DMARC)',
+ 'Verified sender enforcement',
+ ],
+ },
+ {
+ title: 'Security',
+ icon: 'key',
+ items: [
+ 'API keys with expiration, hashing, and IP allowlisting',
+ 'JWT authentication and RBAC',
+ 'Two-factor authentication (TOTP)',
+ 'OAuth / SSO login (Google, Keycloak, authentik, and more)',
+ 'Rate limiting and session management',
+ ],
+ },
+ {
+ title: 'Contacts & Suppression',
+ icon: 'users',
+ items: [
+ 'Contact tracking and segmentation',
+ 'Bounce and complaint handling',
+ 'Automatic suppression lists',
+ ],
+ },
+ {
+ title: 'Workspaces',
+ icon: 'briefcase',
+ items: [
+ 'Multi-tenant architecture with isolated workspaces',
+ 'Role-based access control',
+ 'Shared resources and scoped API keys',
+ ],
+ },
+ {
+ title: 'Webhooks & Events',
+ icon: 'link',
+ items: [
+ 'Event-driven architecture with webhook delivery',
+ 'Retry strategies and delivery tracking',
+ 'Audit logs and real-time event streaming',
+ ],
+ },
+ {
+ title: 'Analytics & Monitoring',
+ icon: 'bar-chart',
+ items: [
+ 'Email delivery metrics and trends',
+ 'Prometheus integration',
+ 'Health endpoints and daily reports',
+ ],
+ },
+]
+
+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' },
+]
+
+
+onMounted(async () => {
+ try {
+ const res = await infoApi.get()
+ appInfo.value = res.data.data
+ } catch {
+ // Non-critical
+ } finally {
+ loading.value = false
+ }
+})
+</script>
+
+<template>
+ <div>
+ <div class="page-header">
+ <h1>About Posta</h1>
+ </div>
+
+ <div v-if="loading" class="loading-page">
+ <div class="spinner"></div>
+ </div>
+
+ <template v-else>
+ <!-- Hero -->
+ <div class="card about-hero">
+ <div class="card-body">
+ <div class="hero-content">
+ <img src="/logo.png" alt="Posta" class="hero-logo" />
+ <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.
+ </p>
+ <div class="hero-meta">
+ <span v-if="appInfo" class="badge badge-info">
+ v{{ appInfo.version }}
+ <template v-if="appInfo.commit_id"> ({{ appInfo.commit_id.slice(0, 7) }})</template>
+ </span>
+ <span class="badge badge-secondary">Apache License 2.0</span>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+
+ <!-- Features -->
+ <div class="about-section">
+ <h2 class="section-title">Core Features</h2>
+ <div class="features-grid">
+ <div v-for="feature in features" :key="feature.title" class="card feature-card">
+ <div class="card-body">
+ <h3 class="feature-title">{{ feature.title }}</h3>
+ <ul class="feature-list">
+ <li v-for="item in feature.items" :key="item">{{ item }}</li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </div>
+
+ <!-- Links -->
+ <div class="about-section">
+ <h2 class="section-title">Resources & SDKs</h2>
+ <div class="card">
+ <div class="card-body">
+ <div class="links-grid">
+ <a
+ v-for="link in links"
+ :key="link.url"
+ :href="link.url"
+ target="_blank"
+ rel="noopener noreferrer"
+ class="about-link"
+ >
+ <span class="about-link-title">{{ link.title }}</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>
+ </a>
+ </div>
+ </div>
+ </div>
+ </div>
+
+ <!-- Footer -->
+ <div class="about-footer">
+ <p>&copy; {{ new Date().getFullYear() }} Jonas Kaninda and contributors</p>
+ </div>
+ </template>
+ </div>
+</template>
+
+<style scoped>
+.about-hero {
+ margin-bottom: 24px;
+}
+
+.hero-content {
+ display: flex;
+ align-items: flex-start;
+ gap: 20px;
+}
+
+.hero-logo {
+ width: 72px;
+ height: 72px;
+ object-fit: contain;
+ flex-shrink: 0;
+}
+
+.hero-title {
+ font-size: 24px;
+ font-weight: 700;
+ margin: 0 0 8px;
+ color: var(--text-primary);
+}
+
+.hero-description {
+ color: var(--text-secondary);
+ line-height: 1.6;
+ margin: 0 0 12px;
+ max-width: 600px;
+}
+
+.hero-meta {
+ display: flex;
+ gap: 8px;
+ flex-wrap: wrap;
+}
+
+.about-section {
+ margin-bottom: 24px;
+}
+
+.section-title {
+ font-size: 18px;
+ font-weight: 600;
+ color: var(--text-primary);
+ margin: 0 0 12px;
+}
+
+.features-grid {
+ display: grid;
+ grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
+ gap: 16px;
+}
+
+.feature-card {
+ margin: 0;
+}
+
+.feature-title {
+ font-size: 15px;
+ font-weight: 600;
+ color: var(--text-primary);
+ margin: 0 0 10px;
+}
+
+.feature-list {
+ margin: 0;
+ padding: 0 0 0 18px;
+ list-style: disc;
+}
+
+.feature-list li {
+ color: var(--text-secondary);
+ font-size: 13px;
+ 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));
+ gap: 10px;
+}
+
+.about-link {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 12px 14px;
+ border-radius: var(--radius-sm, 6px);
+ background: var(--bg-secondary);
+ color: var(--text-primary);
+ text-decoration: none;
+ transition: all var(--transition, 150ms ease);
+ font-size: 14px;
+ font-weight: 500;
+}
+
+.about-link:hover {
+ background: var(--bg-tertiary);
+ color: var(--primary-600, #9333ea);
+}
+
+.about-link svg {
+ color: var(--text-muted);
+ flex-shrink: 0;
+}
+
+.about-link:hover svg {
+ color: var(--primary-600, #9333ea);
+}
+
+.about-footer {
+ text-align: center;
+ padding: 24px 0;
+ color: var(--text-muted);
+ font-size: 13px;
+}
+</style>