LiquidJS

A simple, expressive, extensible Liquid template engine for JavaScript — Shopify, Jekyll and GitHub Pages compatible, for Node.js, browsers, and the CLI, with TypeScript support.

Documentation · Playground · Setup guide · Contributing

_{Try the online playground.}

Quick start

import { Liquid } from 'liquidjs'

const engine = new Liquid()
const html = await engine.parseAndRender(
  'Hello, {{ name | capitalize }}!',
  { name: 'liquid' }
)
//=> 'Hello, Liquid!'

Installation

Node.js

npm install liquidjs

Browser (jsDelivr UMD bundle)

<script src="https://cdn.jsdelivr.net/npm/liquidjs/dist/liquid.browser.min.js"></script>

CLI

npx liquidjs --template 'Hello, {{ name }}!' --context '{"name": "Liquid"}'

See the setup guide for partials, layouts, caching, and other options.

Used by

Products and projects running on LiquidJS. Open a PR to add yours.

Financial Support

If you personally love LiquidJS or it's benefiting your business, please consider financially support us via GitHub Sponsors. Special thanks to our sponsors!

Contributors ✨

Want to contribute? see Contribution Guidelines. Thanks goes to these wonderful people:

Jun Yang 🚧 💻	chenos 💻	Zach Leatherman 🐛	Tim Hardy 💻	Paul Robert Lloyd 💻 🐛	Alec Larson 💻	Patrick Malouin 💻 📖
jaswrks 💻	三三 💻 🤔	ssendev 💻 📖	wojtask9 💻	Andrew Barclay 💻	Cory Mawhorter 💻	Mehdi Jaffery 💻
Robin Bijlani 💻 🐛	Ryan Kennedy 💻	Sami Kukkonen 💻	Scott Santucci 💻	Steven 💡 💻	azu 📖	Joonas 💻
Jamel A. 💻	Brandon Pittman 💻	tgrandgent 💻	Martin Schuster 💻	Ray ⚠️ 💻	Cristofer Gonzales 💻	Raymond Camden 📖
Steve Stedman 📖	Anthony Ciccarello 📖	Bogdan Chadkin 💻	Tejas Manohar 💻	Peter deHaan 📖	amit777 💻	Steffen Schuldenzucker 💻
Pixcell 💻	Jason Etcovitch 💻	ZC 📖	Memmie Lenglet 💻	ilhamdev0 📖	一饮一啄皆是人生 📖	Amit Agarwal 📖
Laurin Quast 💻	Matt Vague 💻	Liam Bigelow 💻	Jason Kurian 📖	d pham (they/them) 📖	Aleksandr Hovhannisyan 💻	jg-rp 💻
Ameya Apte 💻	tbdrz 📖	Santi Albo 📖 💻	Yahang Wu 📖	hongl 📖	zxx-457 📖	prassie 📖
Slav Ivanov 💻	Daniel Rosenberg 💻	bobgubko 💻	BaNgan 📖	Mahyar Pasarzangene 📖	Tomáš Hübelbauer 💻 📖	Jason Garber 💻
Nick Reilingh 📖	Francisco Soto 💻	David LJ 📖	Rasmus Wriedt Larsen 📖	Bruno Carvalho 💻	傅鹏 💻	Joel Hamilton 💻
Max Medve 💻	Cosmin Popovici 📖	Adam Tanner 💻	Guillermo Casal Caro 💻	Josh Soref 📖	Koen 💻	Matthieu Bacconnier 📖
Tim van Dam 💻	Ed Hanton 📖	Vlad GURDIGA 📖	裸奔狂甩丁丁 📖	Ihor Panasiuk 💻	Omri Rosner 💻	immerrr again 📖
Loo Rong Jie 💻	MorielHarush 💻	Peak Twilight 💻	Joe Cottam 💻	Timmy Braun 💻	Tal 💻	Vladimir Filonov 💻
spokodev 💻	YacovGold 💻	Sarath Francis 💻	KBS 💻	Jake Wang 💻	web-orbit12 💻	Josef Guenther 💻
Osama Ansar 💻

License

MIT © Jun Yang