Entrypoints

The left column of each table is a path relative to src/entrypoints. It is the exact string you pass to the vite-tag snippet:

{%- render 'vite-tag' with 'mini-cart/elements/mini-cart.ts' -%}

A script generates the tables below. After adding, moving or removing an entrypoint, run it from the repository root:

python3 doc-site/scripts/build-entrypoint-table.py

The script fills the "Why" column of the second table from the NOTES map at its top. Add a note there for any new file that appears in that table.

src/entrypoints holds 116 files. 62 Liquid files render 101 of them.

Rendered entrypoints

Not rendered by any Liquid file

Other files import some of these as modules. Check before deleting any of them.

How to read the second table

A file with no Liquid consumer is one of three things.

Another entrypoint imports it. Everything under mini-cart/internals/ is in this group. mini-cart.ts imports those files, and Vite emits each one as its own chunk because it sits in the entrypoints directory. The page loads them as module preloads, which you can see in snippets/vite-tag.liquid.

It is a shared module stored in this directory. The booking calendar and a mini-cart rule import utils.ts through the @/ alias.

It is unused. Legacy and unused code lists these files.

Adding a new entrypoint

1. Create the file under src/entrypoints, either directly in that directory or in a subdirectory. The build finds it automatically, and there is no list to update.
2. Run npm run build, or keep npm run dev running, so snippets/vite-tag.liquid regenerates.
3. Render it from your Liquid with the path relative to src/entrypoints, without a leading slash.
4. Regenerate this page.

A vite-tag render whose path matches no branch of the generated snippet outputs nothing and reports no error. If your script does not run, check the path first. See Asset not loading.

How the directory is organised

src/entrypoints/homepage-redesign/components/ holds the homepage sections built during the redesign. A section there usually has a .ts and .css pair, and the same Liquid file renders both.

src/entrypoints/mini-cart/ has two subdirectories. elements/ holds custom elements, each rendered by its own snippet. internals/ holds modules that other files import and no Liquid renders.

src/components/ holds code that other files import and Liquid never renders. Every file in src/entrypoints is a build target, and every file in src/components or src/lib is a module.

Related

• Build pipeline explains how these files compile.
• Codebase map covers the wider directory layout.