Files
liquidjs/docs/source/tutorials/migrate-to-9.md
ed15a52c26 docs: revisit wording & style for liquidjs.com (#906)
* docs: polish theme, playground, and reference pages

Improve readability of the docs site with updated light/dark tokens, shared
code-block styling, and playground editors that follow system color scheme.
Skip CookieHub on localhost, serve the browser bundle from theme source, and
use backtick titles on filter/tag reference pages for consistent navigation.

Co-authored-by: Cursor <[email protected]>

* docs: highlight npx in bash blocks and polish English copy

Use Prism insertBefore for CLI commands like npx, tighten tutorial and reference wording, and keep YAML titles free of backticks so sidebar and page headings stay correct.

Co-authored-by: Cursor <[email protected]>

* docs: restore lowercase filter and tag titles

Titles should match actual filter/tag identifiers (e.g. abs, append), not capitalized English labels.

Co-authored-by: Cursor <[email protected]>

---------

Co-authored-by: Cursor <[email protected]>
2026-06-08 00:26:52 +08:00

1.5 KiB

title
title
Migrate to LiquidJS 9

LiquidJS 9 has some fundamental improvements, including bugfixes, new features and performance improvements due to a higher target (see #137). There are also some breaking changes.

Features

  • Sync rendering: renderSync, parseAndRenderSync, renderFileSync
  • New utils: Expression

Fixes

  • Rewrite boolean expression evaluation order, #130;
  • break and continue tags omitting output before them, #123;
  • Fixes errors in React.js demo during yarn install, #145;
  • Promise typed Drops are not always awaited.

Performance

  • Performance Improvements due to targeting Node.js 8, see #137;
  • Memory footprint is reduced by 57.5%, see #202;
  • Render performance is improved by 100.3%, see #205.

BREAKING CHANGES

  • LiquidJS no longer has a default export, use import {Liquid} from 'liquidjs' instead. The window.Liquid for the UMD bundle is also changed to window.liquidjs.Liquid;
  • The duplicate static method Liquid.evalValue is removed, use the instance method liquid.evalValue instead;
  • Shipped to Node.js 8, the CJS bundle (main entry in Node.js) no longer supports Node.js ≤ 6. ESM (dist/liquid.node.esm.js) and UMD (dist/liquid.browser.umd.js, dist/liquid.browser.min.js) bundles are not affected.