@geenius/emails

Transactional email templates, provider adapters, UI surfaces, and Convex helpers for the Geenius ecosystem.

Repository: https://github.com/geenius-dev/geenius-emails

Installation

pnpm add @geenius/emails

Subpath Imports

import { configureEmails, TEMPLATES } from '@geenius/emails'
import { STATUS_CONFIG } from '@geenius/emails/shared'
import { ResendProvider } from '@geenius/emails/providers'
import { EmailDashboardPage } from '@geenius/emails/react'
import { EmailTemplatesPage as ReactCssTemplatesPage } from '@geenius/emails/react-css'
import '@geenius/emails/react-css/styles.css'
import { createEmails } from '@geenius/emails/solidjs'
import { EmailDashboardPage as SolidCssDashboardPage } from '@geenius/emails/solidjs-css'
import '@geenius/emails/solidjs-css/styles.css'
import { schema, mutations, queries } from '@geenius/emails/convex'

Usage

import type { EmailTemplate } from '@geenius/emails'
import { TemplateGallery } from '@geenius/emails/react'

const templates: EmailTemplate[] = [
  {
    id: 'welcome',
    name: 'Welcome',
    subject: 'Welcome to {{appName}}',
    description: 'Sent after signup to orient a new user.',
    category: 'auth',
    variables: ['appName', 'userName'],
  },
]

export function TemplateBrowser() {
  return <TemplateGallery templates={templates} />
}

Variant Guide

• @geenius/emails: shared contracts, config helpers, templates, errors, and provider factories
• @geenius/emails/shared: shared-only entrypoint for types, constants, and helpers
• @geenius/emails/providers: provider implementations for Resend, SES, SMTP, Postmark, SendGrid, and Plunk
• @geenius/emails/react: React hooks, components, and page surfaces
• @geenius/emails/react-css: standalone React components and pages styled with vanilla CSS
• @geenius/emails/solidjs: SolidJS primitives, components, and page surfaces
• @geenius/emails/solidjs-css: standalone SolidJS components and pages styled with vanilla CSS
• @geenius/emails/convex: schema, queries, mutations, and Convex component wiring

Storybook

React and SolidJS parity demos are available through the local review apps in this repository:

pnpm storybook:react
pnpm storybook:solidjs

• React parity app: apps/storybook-react
• SolidJS parity app: apps/storybook-solidjs

Production builds for the review apps:

pnpm storybook:build:react
pnpm storybook:build:solidjs

License

FSL-1.1-Apache-2.0