# 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