{"id":14700,"library":"meteor-build-client","title":"Meteor Client Bundler","description":"meteor-build-client is a command-line interface (CLI) tool designed to bundle the client-side assets of a Meteor application into a static `index.html` and associated CSS/JS files. This allows the client application to be hosted on any static web server or even loaded directly via the `file://` protocol, decoupling it from a live Meteor server for its static assets. The package is currently at version 1.3.0, with recent updates (like 1.3.0) focusing on compatibility with newer Meteor versions (e.g., `meteor@2.8.0`), bug fixes, and user experience improvements like prompt skipping. Its primary differentiator is enabling a pure client-only Meteor build without requiring the full Meteor server stack for serving the initial bundle, which is useful for CDN deployment or offline access. Release cadence appears tied to Meteor compatibility and addressing reported issues.","status":"active","version":"1.3.0","language":"javascript","source_language":"en","source_url":"https://github.com/frozeman/meteor-build-client","tags":["javascript","meteor","meteor build","meteor build client","meteor build browser","client","client-only","browser-only"],"install":[{"cmd":"npm install meteor-build-client","lang":"bash","label":"npm"},{"cmd":"yarn add meteor-build-client","lang":"bash","label":"yarn"},{"cmd":"pnpm add meteor-build-client","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This package is a command-line interface (CLI) tool and not designed for programmatic import or `require()` usage within JavaScript/TypeScript applications. It is installed globally and run as a shell command.","wrong":"import { buildClient } from 'meteor-build-client';","symbol":"meteor-build-client","correct":"npm install -g meteor-build-client\n# Then use in shell: meteor-build-client "},{"note":"Interaction is solely via command-line arguments. There is no public programmatic API to instantiate or call functions from this package directly within a Node.js script beyond spawning a child process.","wrong":"const builder = new MeteorBuildClient(); builder.build();","symbol":"CLI Options","correct":"meteor-build-client --help\nmeteor-build-client ../output --settings ../settings.json"},{"note":"The tool processes special `` and `` tags in your `index.html` to inject generated asset links. These are not JavaScript imports but HTML placeholders the CLI tool understands.","wrong":"import 'meteor-build-client/bundle-styles.css';","symbol":"Output integration","correct":"\n\n \n\n\n \n"}],"quickstart":{"code":"npm install -g meteor-build-client\n\n# Navigate to your Meteor application directory\ncd /path/to/my/meteor/app\n\n# Example 1: Build client into a new directory\nmeteor-build-client ../client-output --url https://my-cdn.com\n\n# Example 2: Use a pre-built Meteor bundle (e.g., from 'meteor build --directory')\nmeteor build ../full-app-build --directory\nmeteor-build-client ../client-output-from-full --url https://my-cdn.com --usebuild ../full-app-build\n\n# Example 3: Build with settings.json and skip overwrite prompt\nmeteor-build-client ../client-output --settings ./settings.json --yci","lang":"shell","description":"This quickstart demonstrates how to install the `meteor-build-client` CLI globally and use it to bundle a Meteor application's client-side assets into a static directory, including options for specifying a ROOT_URL, using a pre-existing Meteor build, and passing application settings, while skipping prompts."},"warnings":[{"fix":"Remove any usage of `-hide` or `--hideSpinner` flags from your build scripts.","message":"The spinner functionality and associated command-line options (`-hide`, `--hideSpinner`) were removed in version 1.0.0. The `simple-spinner` dependency was also dropped.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Always specify a dedicated, empty, or expendable directory as the output target. Use the `-y` or `--yci` flags to explicitly confirm overwriting in CI/CD environments if desired.","message":"The content of the specified output directory will be deleted before a new build. This can lead to data loss if important files are stored there. As of v1.3.0, a prompt is shown before overwriting, unless `-y` or `--yci` flags are used.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Avoid using dynamic `import()` statements in your Meteor client-side code when bundling with `meteor-build-client`. Use static imports or alternative loading mechanisms.","message":"Dynamic imports (e.g., `import('/eager/file')`) are not supported by `meteor-build-client` and will cause issues or errors in the bundled output.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Verify your Meteor project's build settings for modern/legacy targets. If bundling a pre-built Meteor directory, ensure that directory contains the desired build targets.","message":"The package defaults to linking the `legacy` ES5 bundle build. If you require a modern ES6 build, you need to ensure your Meteor project is configured accordingly and potentially use the `--usebuild` option with a specifically generated modern build.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-19T00:00:00.000Z","next_check":"2026-07-18T00:00:00.000Z","problems":[{"fix":"Clear the output directory manually before running the command, or add the `-y` or `--yci` flag to `meteor-build-client` to automatically confirm overwrites: `meteor-build-client ../output --yci`.","cause":"The output directory for `meteor-build-client` already contains files, and the tool is configured to prompt before overwriting (default behavior before v1.3.0, or if `--yci` is not used).","error":"Error: EEXIST: file already exists, open '...' (output directory)"},{"fix":"Ensure `meteor-build-client` is run with the `--url ` option pointing to your Meteor backend server (e.g., `meteor-build-client ../output --url https://api.yourdomain.com`). Also verify network connectivity and server availability.","cause":"The bundled client application is trying to connect to a Meteor server, but `ROOT_URL` is not correctly set, or the client cannot reach the server at the specified URL.","error":"ReferenceError: Meteor is not defined"},{"fix":"This was addressed in version 1.2.1. Update `meteor-build-client` to version 1.2.1 or newer: `npm update -g meteor-build-client`.","cause":"An internal issue within the bundler sometimes caused multiple entries for the same file in the generated `index.html`.","error":"File duplicates in generated markup"}],"ecosystem":"npm"}