parse-server-resend-adapter
Advanced tools
A modern email adapter for Parse Server that uses Resend to send beautiful, customizable emails with React Email templates.
npm install parse-server-resend-adapter
# or
yarn add parse-server-resend-adapter
# or
pnpm add parse-server-resend-adapter
Sign up at Resend and get your API key from the dashboard.
import { ResendEmailAdapter } from 'parse-server-resend-adapter';
const parseServer = new ParseServer({
// ... other Parse Server options
emailAdapter: new ResendEmailAdapter({
apiKey: 'your-resend-api-key',
defaultFrom: 'noreply@yourdomain.com',
brandLogoUrl: 'https://yourdomain.com/logo.png', // optional
brandColor: '#007bff', // optional, defaults to #000000
}),
appName: 'Your App Name',
publicServerURL: 'https://yourserver.com/parse',
});
Parse Server will now use Resend to send verification emails and password reset emails with beautiful, responsive templates.
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
apiKey | string | ✅ | - | Your Resend API key |
defaultFrom | string | ✅ | - | Default sender email address |
brandLogoUrl | string | ❌ | - | URL to your brand logo (displayed in emails) |
brandColor | string | ❌ | #000000 | Brand color for buttons and accents |
templates | object | ❌ | - | Custom email templates (see below) |
⚠️ Version Compatibility Warning
When using custom templates, ensure that your project uses compatible versions of React Email dependencies with this adapter. Version mismatches can cause rendering errors like "Objects are not valid as a React child".
Required versions:
@react-email/components:^0.3.1react:^19.0.0react-dom:^19.0.0If you encounter rendering errors with custom templates, check that your project's
package.jsonuses compatible versions.
You can provide your own React Email templates for verification and password reset emails:
import { ResendEmailAdapter } from 'parse-server-resend-adapter';
import MyVerificationTemplate from './templates/MyVerificationTemplate';
import MyPasswordResetTemplate from './templates/MyPasswordResetTemplate';
const adapter = new ResendEmailAdapter({
apiKey: 'your-resend-api-key',
defaultFrom: 'noreply@yourdomain.com',
templates: {
verification: MyVerificationTemplate,
passwordReset: MyPasswordResetTemplate,
},
});
Your custom templates will receive the following props:
Verification Email Template:
{
link: string; // Verification link
appName: string; // Your app name
brandLogoUrl?: string; // Your brand logo URL
brandColor?: string; // Your brand color
}
Password Reset Email Template:
{
link: string; // Password reset link
appName: string; // Your app name
brandLogoUrl?: string; // Your brand logo URL
brandColor?: string; // Your brand color
}
import { Html, Head, Body, Container, Text, Button } from '@react-email/components';
export const MyVerificationTemplate = ({
link,
appName,
brandLogoUrl,
brandColor = '#007bff'
}) => {
return (
<Html>
<Head />
<Body style={{ fontFamily: 'Arial, sans-serif' }}>
<Container>
<Text>Welcome to {appName}!</Text>
<Text>Please verify your email address:</Text>
<Button
href={link}
style={{
backgroundColor: brandColor,
color: 'white',
padding: '12px 24px',
borderRadius: '6px',
textDecoration: 'none'
}}
>
Verify Email
</Button>
</Container>
</Body>
</Html>
);
};
The adapter comes with beautiful, responsive default templates that include:
You can also configure the adapter using environment variables:
RESEND_API_KEY=your-resend-api-key
EMAIL_FROM=noreply@yourdomain.com
EMAIL_BRAND_LOGO_URL=https://yourdomain.com/logo.png
EMAIL_BRAND_COLOR=#007bff
const adapter = new ResendEmailAdapter({
apiKey: process.env.RESEND_API_KEY,
defaultFrom: process.env.EMAIL_FROM,
brandLogoUrl: process.env.EMAIL_BRAND_LOGO_URL,
brandColor: process.env.EMAIL_BRAND_COLOR,
});
The main adapter class that extends Parse Server's MailAdapter.
sendMail(options)Send a custom email.
await adapter.sendMail({
to: 'user@example.com',
subject: 'Hello World',
text: 'Plain text content',
html: '<h1>HTML content</h1>', // optional
from: 'sender@yourdomain.com', // optional, uses defaultFrom if not provided
});
sendVerificationEmail({ link, appName, user })Send a verification email (called automatically by Parse Server).
sendPasswordResetEmail({ link, appName, user })Send a password reset email (called automatically by Parse Server).
This error typically occurs when there are version mismatches between React Email dependencies. To fix:
Check your dependencies - Ensure your project uses compatible versions:
{
"@react-email/components": "^0.3.1",
"react": "^19.0.0",
"react-dom": "^19.0.0"
}
Update package versions - If using older versions, update them:
npm install @react-email/components@^0.3.1 react@^19.0.0 react-dom@^19.0.0
Clear node_modules - Sometimes a clean install helps:
rm -rf node_modules package-lock.json
npm install
Use default templates - If custom templates still don't work, the default templates will always work as a fallback.
@react-email/components for email-safe rendering# Clone the repository
git clone https://github.com/0xtiby/parse-server-resend-adapter.git
# Install dependencies
npm install
# Build the package
npm run build
Contributions are welcome! Please feel free to submit a Pull Request.
MIT License - see the LICENSE file for details.
Made with ❤️ by 0xtiby
FAQs
Package description
We found that parse-server-resend-adapter demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
/Security News
Socket uncovered secret-stealing workflows that ran in LiteLLM’s GitHub repository 11 days before the supply chain attack on PyPI and Docker.
Security News
Cloudflare introduces tsrs, a Rust port of TypeScript’s compiler promising faster checks and lower memory use, with the TypeScript team’s help.
Security News
The PHP Foundation says Chainguard broke a security embargo ahead of critical RCE patches, as leaks disrupted the coordinated release.