{"id":40934,"library":"esbuild-plugin-lingui-react-email-macro","title":"esbuild-plugin-lingui-react-email-macro","description":"An esbuild plugin that transforms Lingui i18n macros in React Email files before bundling. Version 1.0.2. It integrates Lingui's macro system (like t, plural, select) with React Email's build pipeline, extracting translations and converting macros to runtime calls. Key differentiator: specifically designed for use with React Email, not generic Lingui esbuild setups.","status":"active","version":"1.0.2","language":"javascript","source_language":"en","source_url":"https://github.com/itsyoboieltr/esbuild-plugin-lingui-react-email-macro","tags":["javascript","esbuild-plugin","lingui","react-email","typescript"],"install":[{"cmd":"npm install esbuild-plugin-lingui-react-email-macro","lang":"bash","label":"npm"},{"cmd":"yarn add esbuild-plugin-lingui-react-email-macro","lang":"bash","label":"yarn"},{"cmd":"pnpm add esbuild-plugin-lingui-react-email-macro","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency; plugin runs as an esbuild plugin.","package":"esbuild","optional":false},{"reason":"Target framework; plugin transforms macros in React Email files.","package":"react-email","optional":true}],"imports":[{"note":"Named export only; no default export.","wrong":"import linguiReactEmailMacro from 'esbuild-plugin-lingui-react-email-macro'","symbol":"linguiReactEmailMacro","correct":"import { linguiReactEmailMacro } from 'esbuild-plugin-lingui-react-email-macro'"},{"note":"CommonJS destructured require is correct.","wrong":"const linguiReactEmailMacro = require('esbuild-plugin-lingui-react-email-macro')","symbol":"linguiReactEmailMacro","correct":"const { linguiReactEmailMacro } = require('esbuild-plugin-lingui-react-email-macro')"},{"note":"Plugin type is from esbuild, not from this package.","wrong":"import { Plugin } from 'esbuild-plugin-lingui-react-email-macro'","symbol":"Plugin type","correct":"import type { Plugin } from 'esbuild'"}],"quickstart":{"code":"import { build } from 'esbuild';\nimport { linguiReactEmailMacro } from 'esbuild-plugin-lingui-react-email-macro';\n\nbuild({\n  entryPoints: ['src/email.tsx'],\n  outfile: 'dist/email.js',\n  bundle: true,\n  plugins: [linguiReactEmailMacro()],\n}).catch(() => process.exit(1));","lang":"typescript","description":"Demonstrates using the plugin with esbuild to bundle a React Email file with Lingui macros."},"warnings":[{"fix":"Include linguiReactEmailMacro() in the plugins array.","message":"Plugin must be placed in the plugins array; accidental omission will leave macros untransformed.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Ensure your project has Lingui set up (lingui.config.js) and macros are enabled.","message":"Requires that Lingui is configured with babel macro support; plugin only transforms macros, it does not configure Lingui.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use a general Lingui esbuild plugin for non-email React projects.","message":"This plugin is specifically for React Email; using it with non-email React code may not work as expected.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"search_vec":"'1.0.2':23 'build':38 'bundl':21 'call':47 'convert':43 'design':51 'differenti':49 'email':6,18,36,56,69 'esbuild':2,9,60,64 'esbuild-plugin':63 'esbuild-plugin-lingui-react-email-macro':1 'extract':40 'file':19 'generic':58 'i18n':14 'integr':25 'javascript':62 'key':48 'like':30 'lingui':4,13,26,59,66 'macro':7,15,28,44 'pipelin':39 'plugin':3,10,65 'plural':32 'react':5,17,35,55,68 'react-email':67 'runtim':46 'select':33 'setup':61 'specif':50 'system':29 'transform':12 'translat':41 'typescript':70 'use':53 'version':22","created_at":"2026-06-04T18:49:58.397901+00:00","updated_at":"2026-06-04T18:49:58.397901+00:00","problems":[{"fix":"Ensure lingui.config.js exists and the plugin is added to esbuild's plugins array.","cause":"Lingui macros not configured or plugin not applied before bundling.","error":"Error: Macro not found for 't'"},{"fix":"Use import { linguiReactEmailMacro } from 'esbuild-plugin-lingui-react-email-macro'.","cause":"Incorrect import: attempting to use default import instead of named.","error":"TypeError: plugin is not a function"},{"fix":"Install react-email: npm install react-email.","cause":"React Email package not installed, but it is required for the plugin's intended use.","error":"Module not found: Error: Can't resolve 'react-email'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/itsyoboieltr/esbuild-plugin-lingui-react-email-macro#readme","github":"https://github.com/itsyoboieltr/esbuild-plugin-lingui-react-email-macro","docs":null,"changelog":null,"pypi":null,"npm":"esbuild-plugin-lingui-react-email-macro","openapi_spec":null,"status_page":null,"smithery":null,"categories":["testing"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-04","next_check":"2026-09-02","install_tag":null}}