# ng-email
> Build HTML emails as standalone Angular components. ng-email renders them to the table-based, inline-styled HTML that Gmail, Outlook and Apple Mail expect, with a plain-text version alongside.
Packages: `@ng-email/render` (renderEmail, renderEmailBoth, defineEmails), `@ng-email/components` (EMAIL_COMPONENTS: ngeHtml, ngeHead, ngeBody, nge-preview, ngeContainer, ngeSection, ngeRow, ngeColumn, ngeText, ngeHeading, ngeLink, ngeButton, ngeImg, ngeHr, nge-font) and `@ng-email/cli` (ng-email build, preview, export, check, add, mcp). Requires Angular 22.
Rules that matter: lay out with tables (table ngeContainer, table ngeRow + td ngeColumn), never flexbox or grid; put styles in [ngeStyle], never in component styles; make per-recipient values signal inputs; use absolute https URLs and alt text on images.
AI agents: run the MCP server with `npx -y @ng-email/cli mcp`, or install the agent skill with `npx skills add yshashi/ng-email`. See https://yshashi.github.io/ng-email/docs/ai-agents.md.
## Getting started
- [Introduction](https://yshashi.github.io/ng-email/docs/introduction.md): ng-email lets you write HTML emails as standalone Angular components and render them into the table-based, inline-styled HTML that email clients expect.
- [Installation](https://yshashi.github.io/ng-email/docs/installation.md): Add ng-email to an existing Angular project or to any TypeScript project that will render emails.
- [Your first email](https://yshashi.github.io/ng-email/docs/first-email.md): Write a welcome email, preview it in the browser, and render it from a Node script. This takes about ten minutes.
## Guides
- [Rendering](https://yshashi.github.io/ng-email/docs/rendering.md): Turn a component into email HTML and plain text, and learn what the renderer guarantees.
- [Previewing and exporting](https://yshashi.github.io/ng-email/docs/preview-and-export.md): See your emails while you write them, and render all of them to files for review or CI.
- [Sending](https://yshashi.github.io/ng-email/docs/sending.md): ng-email renders; your email provider sends. This page shows how to wire the two together in a Node service.
- [Blocks and templates](https://yshashi.github.io/ng-email/docs/blocks.md): Start from ready-made sections and complete emails, then make them yours.
- [Styling](https://yshashi.github.io/ng-email/docs/styling.md): Email clients only reliably support inline styles. ng-email builds those for you from ngeStyle.
- [AI and agents](https://yshashi.github.io/ng-email/docs/ai-agents.md): Let a coding agent such as Claude Code, Cursor, GitHub Copilot or Codex write, check and fix your emails with ng-email.
## Reference
- [Components](https://yshashi.github.io/ng-email/docs/components.md): Every component in @ng-email/components, with its selector, inputs and the markup it produces.
- [CLI](https://yshashi.github.io/ng-email/docs/cli.md): The ng-email command from @ng-email/cli.
- [Render API](https://yshashi.github.io/ng-email/docs/api.md): Everything exported by @ng-email/render.
## Templates
- [Welcome](https://yshashi.github.io/ng-email/r/welcome.json): Greeting, three first steps and a dashboard button. Add with `npx ng-email add welcome`.
- [Order receipt](https://yshashi.github.io/ng-email/r/receipt.json): Items, totals, shipping address and order tracking. Add with `npx ng-email add receipt`.
- [Password reset](https://yshashi.github.io/ng-email/r/password-reset.json): Reset button, expiry and a "not you?" note. Add with `npx ng-email add password-reset`.
- [Sign-in code](https://yshashi.github.io/ng-email/r/login-code.json): A one-time code with a magic-link fallback. Add with `npx ng-email add login-code`.
- [Team invitation](https://yshashi.github.io/ng-email/r/team-invite.json): Who invited them, to which team, and an accept button. Add with `npx ng-email add team-invite`.
## Blocks
- [Header with centered menu](https://yshashi.github.io/ng-email/r/header-centered.json): Wordmark centered above a row of navigation links. Add with `npx ng-email add header-centered`.
- [Header with side menu](https://yshashi.github.io/ng-email/r/header-split.json): Logo mark and wordmark on the left, links on the right. Add with `npx ng-email add header-split`.
- [Centered hero](https://yshashi.github.io/ng-email/r/hero-centered.json): Eyebrow, headline, supporting text and one call to action. Add with `npx ng-email add hero-centered`.
- [Primary and secondary buttons](https://yshashi.github.io/ng-email/r/button-pair.json): Two actions side by side, with Outlook-safe padding. Add with `npx ng-email add button-pair`.
- [Full-width button with fallback link](https://yshashi.github.io/ng-email/r/button-full.json): A block-level call to action plus a copyable link. Add with `npx ng-email add button-full`.
- [Avatar with name and role](https://yshashi.github.io/ng-email/r/avatar-profile.json): Initials avatar that shows even with images blocked. Add with `npx ng-email add avatar-profile`.
- [Avatar group](https://yshashi.github.io/ng-email/r/avatar-group.json): A row of initials avatars with a "+N" count. Add with `npx ng-email add avatar-group`.
- [Feature checklist](https://yshashi.github.io/ng-email/r/features-checklist.json): Heading and a checklist of features with descriptions. Add with `npx ng-email add features-checklist`.
- [Two-column feature grid](https://yshashi.github.io/ng-email/r/features-grid.json): Numbered features laid out in a 2-column grid. Add with `npx ng-email add features-grid`.
- [Numbered steps](https://yshashi.github.io/ng-email/r/list-steps.json): Onboarding or setup steps with numbered badges. Add with `npx ng-email add list-steps`.
- [Stats row](https://yshashi.github.io/ng-email/r/stats-row.json): Three key numbers with week-over-week change. Add with `npx ng-email add stats-row`.
- [Customer quote](https://yshashi.github.io/ng-email/r/testimonial-quote.json): A quote with an accent rule, avatar, name and company. Add with `npx ng-email add testimonial-quote`.
- [Pricing card](https://yshashi.github.io/ng-email/r/pricing-card.json): One plan with price, inclusions and an upgrade button. Add with `npx ng-email add pricing-card`.
- [Product card](https://yshashi.github.io/ng-email/r/product-card.json): Product image beside name, price and a buy button. Add with `npx ng-email add product-card`.
- [Order summary](https://yshashi.github.io/ng-email/r/order-summary.json): Line items with subtotal, shipping, tax and total. Add with `npx ng-email add order-summary`.
- [Article card](https://yshashi.github.io/ng-email/r/article-card.json): Cover image, category, headline, excerpt and link. Add with `npx ng-email add article-card`.
- [Image grid](https://yshashi.github.io/ng-email/r/gallery-grid.json): A 2×2 grid of linked images with alt text. Add with `npx ng-email add gallery-grid`.
- [Divider with label](https://yshashi.github.io/ng-email/r/divider-label.json): A horizontal rule with text in the middle. Add with `npx ng-email add divider-label`.
- [One-click rating](https://yshashi.github.io/ng-email/r/feedback-rating.json): Score links from 1 to 5: no forms or scripts needed. Add with `npx ng-email add feedback-rating`.
- [Simple footer](https://yshashi.github.io/ng-email/r/footer-simple.json): Company, postal address and unsubscribe link. Add with `npx ng-email add footer-simple`.
- [Footer with link columns](https://yshashi.github.io/ng-email/r/footer-columns.json): Brand and tagline with two columns of links and a legal line. Add with `npx ng-email add footer-columns`.
## Optional
- [All docs in one file](https://yshashi.github.io/ng-email/llms-full.txt)
- [Registry index](https://yshashi.github.io/ng-email/r/index.json): every block and template as JSON