Standalone Bundle

The standalone command allows you to create a standalone JavaScript bundle containing Intlayer and any other specified packages. This is particularly useful for using Intlayer in environments without a package manager or bundler, such as a plain HTML/JS application.

The bundle uses esbuild to combine the requested packages and their dependencies into a single file that can be easily imported into any web project.

Usage

npx intlayer standalone --packages [packages...] [options]

Options

• -o, --outfile [outfile] - Optional. The name of the output file. Defaults to intlayer-bundle.js.
• --packages [packages...] - Required. A list of packages to include in the bundle (e.g., intlayer, vanilla-intlayer).
• --version [version] - Optional. The version of the packages to bundle. If not specified, it defaults to the version of the Intlayer CLI.
• --minify - Optional. Whether to minify the output. Defaults to true.
• --platform [platform] - Optional. The target platform for the bundle (e.g., browser, node). Defaults to browser.
• --format [format] - Optional. The output format for the bundle (e.g., esm, cjs, iife). Defaults to esm.

Common Options

• --env-file [envFile] - Environment file.
• -e, --env [env] - Environment.
• --base-dir [baseDir] - Base directory.
• --no-cache - Disable cache.
• --ci - Run the command in every Intlayer project of the monorepo (or only the current one when run from a project directory). Per-project credentials can be injected via INTLAYER_PROJECT_CREDENTIALS, a JSON map of project path to { "clientId", "clientSecret" }.
• --verbose - Verbose output.

Examples:

Create a bundle for Vanilla JS:

npx intlayer standalone --packages intlayer vanilla-intlayer --outfile intlayer.js

This will create an intlayer.js file containing both intlayer and vanilla-intlayer packages, minified and in ESM format, ready to be used in a browser via a <script> tag.

Bundle a specific version:

npx intlayer standalone --packages intlayer --version 8.6.4

Bundle with different format:

npx intlayer standalone --packages intlayer --format iife

What it does:

1. Creates a temporary environment - Sets up a temporary directory to manage dependencies.
2. Installs packages - Uses npm or bun (if available) to install the requested packages and their dependencies.
3. Generates an entry point - Creates a temporary entry file that exports all requested packages and exposes them as global variables when running in a browser.
4. Bundles with esbuild - Uses esbuild to bundle everything into a single file, applying minification and formatting as requested.
5. Outputs the file - Writes the resulting bundle to your specified output path.

Global Variables

When the bundle is loaded in a browser, it exposes the requested packages as global variables on the window object. The variable names are derived from the package names (e.g., intlayer becomes Intlayer, vanilla-intlayer becomes VanillaIntlayer).

// Accessing Intlayer from the bundle
const { getLocaleName } = window.Intlayer;
const { installIntlayer, useIntlayer } = window.VanillaIntlayer;