Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shellscape/jsx-email
Build emails with a delightful DX
https://github.com/shellscape/jsx-email
Last synced: 3 days ago
JSON representation
Build emails with a delightful DX
- Host: GitHub
- URL: https://github.com/shellscape/jsx-email
- Owner: shellscape
- License: mit
- Created: 2023-09-04T17:02:22.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-29T15:22:15.000Z (3 months ago)
- Last Synced: 2024-10-29T15:24:54.397Z (3 months ago)
- Language: TypeScript
- Homepage: https://jsx.email
- Size: 62.3 MB
- Stars: 1,047
- Watchers: 5
- Forks: 35
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- my-awesome-list - jsx-email
README
[npm]: https://img.shields.io/npm/v/jsx-email
[npm-url]: https://www.npmjs.com/package/jsx-email
[![npm][npm]][npm-url]
[](https://discord.gg/FywZN57mTg)
[](https://liberamanifesto.com)
JSX email provides a set of React components and helpers for building delightful and responsive email templates, compatible with modern email clients.
The components handle the heavy lifting of compatibility and client inconsistency so designers and developers can focus on building impactful and engaging templates.
## Migrating to Version 2.0.0
Version 2 represents a big leap forward for the project, but it's not without a few bumps. As with most major version releases in the Node ecosystem, there are a few breaking changes (nothing major) and steps to be performed. Please read our [Migration Guide](https://jsx.email/docs/v2/migration).
To browse the source code and documentation markdown for v1.12.1 please [click here](https://github.com/shellscape/jsx-email/tree/545ad7550fef11cc18fafe71c772c7b66a8b2373).
## Getting Started
Everything to know about the components, props, and usage is available within our [Documentation Site](https://jsx.email/docs/introduction). Please give that a read and let us know if there's anything we can help with.
## Requirements
The packages and components that make up JSX email require an [LTS](https://github.com/nodejs/Release) Node version (v18.0.0+) and React v18.2.0+
Compatible with all modern email services
## Components
A list of available components can be found on the [`jsx-email` Documentation](https://jsx.email/docs/introduction)
## Advantages Over `react-email`
The goals of this project are to provide an improved focus on Developer Experience, maintenance, fast improvements and fast releases. As such, we feel that `jsx-email` has a number of improvements and advantages over `react-email`. Those include:
- [Email Client Compatibility Checking](https://jsx.email/docs/core/cli#client-compatibility-check)
- Exclusive Components
- Optional Configuration Files
- Plugins
- Crazy fast Tailwind support
- Support for `` and `async` within Components
- Enhanced Developer Experience (DX)
- Better Command Line tools
- Works with Monorepos out of the box. No exhaustive setup needed.
- Less complex, smoother Preview Server
- Faster improvements, feature development, and releases
- Community-driven maintenance rather than company-planning priority
- No vendor lock-in for tools. `jsx-email` uses only generic components and tools
## Service Integrations
Email built and rendered with JSX email can be used with any email provider that provides an API for sending email as a `String`.
This includes [AWS SES](https://aws.amazon.com/ses), [Loops](https://loops.so), [Nodemailer](https://nodemailer.com), [Postmark](https://postmarkapp.com),[Resend](https://resend.com), [Plunk](https://www.useplunk.com/), and [SendGrid](https://sendgrid.com). See our documentation on [Email Providers](https://jsx.email/docs/email-providers) for more info and example usage.
## Contributing, Working With This Repo
We 💛 contributions! After all, this is a community-driven project. We have no corporate sponsorship or backing. The maintainers and users keep this project going!
Please check out our [Contribution Guide](./CONTRIBUTING.md).
## Attribution 🧡
This project was built upon prior work for `react-email` by Bu Kinoshita ([@bukinoshita](https://twitter.com/bukinoshita)) and Zeno Rocha ([@zenorocha](https://twitter.com/zenorocha)).
`jsx-email` is a fork of `react-email`.
We (the maintainers) use JSX email daily. This fork was originally created as a canary channel for fixes from pull requests and issues that had been left unaddressed. JSX email grew faster, and the upstream team didn't give the project the love we felt it needed. When our help wasn't accepted, we felt a new direction was warranted.
## License
[MIT License](./LICENSE.md)