eta (η)

Documentation - Chat - RunKit Demo - Playground

[logo]: https://img.shields.io/badge/all_contributors-10-orange.svg "Number of contributors on All-Contributors" [![GitHub package.json version (main)](https://img.shields.io/github/package-json/v/eta-dev/eta/main?label=current%20version)](https://www.npmjs.com/package/eta) [![GitHub Actions Status](https://github.com/eta-dev/eta/actions/workflows/test.yml/badge.svg)](https://github.com/eta-dev/eta/actions) [![All Contributors][logo]](#contributors-) [![Coveralls](https://img.shields.io/coveralls/eta-dev/eta.svg?branch=main)](https://coveralls.io/github/eta-dev/eta?branch=main) [![Donate](https://img.shields.io/badge/donate-paypal-blue.svg)](https://paypal.me/bengubler) **You're viewing the source for Eta v3, which we just released! For v2, visit [the old branch](https://github.com/eta-dev/eta/tree/v2).** ## Summary Eta is a lightweight and blazing fast embedded JS templating engine that works inside Node, Deno, and the browser. It's written in TypeScript and emphasizes great performance, configurability, and small bundle size. ### 🌟 Features - 📦 0 dependencies - 💡 Only ~3.5 KB minzipped - ⚡️ Written in TypeScript - ✨ Deno support (+ Node and browser) - 🚀 Super Fast - 🔧 Configurable - Plugins, custom delimiters, caching - 🔨 Powerful - Precompilation, partials, async - **Layout support**! - 🔥 Reliable - Better quotes/comments support - _ex._ `<%= someval + "string %>" %>` compiles correctly, while it fails with doT or EJS - Great error reporting - ⚡️ Exports ES Modules as well as UMD - 📝 Easy template syntax ## Get Started _For more thorough documentation, visit [https://eta.js.org](https://eta.js.org)_ Install Eta ```bash npm install eta ``` In the root of your project, create `templates/simple.eta` ```eta Hi <%= it.name %>! ``` Then, in your JS file: ```js import { Eta } from "eta"; // import { Eta } from "https://deno.land/x/eta@v3.1.0/src/index.ts"; const eta = new Eta({ views: path.join(__dirname, "templates") }); // Render a template const res = eta.render("./simple", { name: "Ben" }); console.log(res); // Hi Ben! ``` ## FAQs

Where did Eta's name come from?

"Eta" means tiny in Esperanto. Plus, it can be used as an acronym for all sorts of cool phrases: "ECMAScript Template Awesomeness", "Embedded Templating Alternative", etc.... Additionally, Eta is a letter of the Greek alphabet (it stands for all sorts of cool things in various mathematical fields, including efficiency) and is three letters long (perfect for a file extension).

## Integrations

Visual Studio Code

[@shadowtime2000](https://github.com/shadowtime2000) created [eta-vscode](https://marketplace.visualstudio.com/items?itemName=shadowtime2000.eta-vscode).

ESLint

[eslint-plugin-eta](https://github.com/eta-dev/eslint-plugin-eta) was created to provide an ESLint processor so you can lint your Eta templates.

Webpack

Currently there is no official Webpack integration but [@clshortfuse](https://github.com/clshortfuse) shared the loader he uses: ```javascript { loader: 'html-loader', options: { preprocessor(content, loaderContext) { return eta.render(content, {}, { filename: loaderContext.resourcePath }); }, }, } ```

Node-RED

To operate with Eta templates in Node-RED: [@ralphwetzel/node-red-contrib-eta](https://flows.nodered.org/node/@ralphwetzel/node-red-contrib-eta)

## Projects using `eta` - [Docusaurus v2](https://v2.docusaurus.io): open-source documentation framework that uses Eta to generate a SSR build - [swagger-typescript-api](https://github.com/acacode/swagger-typescript-api): Open source typescript api codegenerator from Swagger. Uses Eta as codegenerator by templates - [html-bundler-webpack-plugin](https://github.com/webdiscus/html-bundler-webpack-plugin): Webpack plugin make easily to bundle HTML pages from templates, source styles and scripts - [SmartDeno](https://github.com/guildenstern70/SmartDeno): SmartDeno is an easy to setup web template using Deno & Oak - [Add yours!](https://github.com/eta-dev/eta/edit/master/README.md) ## Contributors Made with ❤ by [@nebrelbug](https://github.com/eta-dev) and all these wonderful contributors ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):

_{Ben Gubler} 💻 💬 📖 ⚠️	_{Clite Tailor} 🤔 💻	_{Ioan CHIRIAC} 💻 🤔	_{Craig Morten} 💻	_{Rajan Tiwari} 💡	_{shadowtime2000} 💻 🤔 ⚠️	_{Hamza Hamidi} 📖
_{Calum Knott} 🤔	_nhaef 💻	_Gün 💻

This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. Contributions of any kind are welcome! ## Credits - Async support, file handling, and error formatting were based on code from [EJS](https://github.com/mde/ejs), which is licensed under the Apache-2.0 license. Code was modified and refactored to some extent. - Syntax and some parts of compilation are heavily based off EJS, Nunjucks, and doT.

	Stars	Issues	Version	Updated	Created
eta	1,303	16	3.4.0	2 months ago	11 years ago
liquidjs	1,410	14	10.12.0	10 days ago	7 years ago
marko			5.34.3	7 days ago	10 years ago
nunjucks	8,452	330	3.2.4	a year ago	12 years ago
twig	1,874	55	1.17.1	6 months ago	13 years ago

eta vs liquidjs vs marko vs nunjucks vs twig

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Popular Searches

Sick of boring JavaScript newsletters?

Downloads in past