Skip to content

Sample viewer (read-only)

This page documents the sample/reference viewer for .liel data. The interactive HTML lives in docs/guide/sample-viewer/app/ so it does not collide with this MkDocs page at /guide/sample-viewer/.

Open the interactive viewer (export JSON only).

Design stance:

  • input: documented JSON from liel export only
  • rendering: browser UI using embedded JS libraries
  • non-goal: parsing .liel binary bytes in the browser

The viewer starts with a bundled sample from the trace-why-postgres scenario so you can inspect the UI immediately.

Quick try

From the repository root:

python examples/demo_memory/make_demo_files.py --force
liel export target/demo-memory/base.liel -o target/demo-memory/base.export.json

Then open docs/guide/sample-viewer/app/index.html in your browser. You can keep the bundled sample, or load:

  • target/demo-memory/base.export.json

MkDocs / local preview / GitHub Pages

This viewer is under docs/. With site_url set to the GitHub Pages project site, mkdocs serve uses the /liel/ prefix (same as production):

  • documentation (this page): http://127.0.0.1:8000/liel/guide/sample-viewer/
  • interactive viewer: http://127.0.0.1:8000/liel/guide/sample-viewer/app/

Published site (after deploy from hy-token/liel): https://hy-token.github.io/liel/guide/sample-viewer/ and https://hy-token.github.io/liel/guide/sample-viewer/app/.