// Use when understanding the build system, modifying CLI commands, working with isobuild, or navigating the tools/ directory. Covers build pipeline flow and file locations.
Use when writing tests, debugging test failures, running the test suite, or setting up test infrastructure. Covers self-test, package tests, and modern E2E tests.
Use when bumping Meteor package versions for beta, RC, or official releases. Covers the two version schemes (meteor-tool vs all other packages), the update-semver automation tool, manual files the tool does not handle, and the full lifecycle from beta through official release. Applies to packages/*/package.js, scripts/admin/, npm-packages/meteor-installer/, and .meteor/versions in test apps.
Use for writing, reviewing, editing, or generating Meteor release changelog entries. Defines canonical file locations, naming rules, required section structure, formatting conventions, PR-based generation workflow (with gh CLI and web fallback), incremental updates, and common entry patterns. Applies to files under v3-docs/docs/generators/changelog/versions/.
Use when analyzing release branch changes for missing user-facing documentation. Compares the release branch against devel, filters for user-facing changes, scans v3-docs/docs/ for coverage, and produces a gap report (.md file) with prioritized documentation opportunities. Does NOT write documentation — only identifies gaps and outputs a plan for later action.
Use when adding, modifying, or reviewing E2E test apps/skeletons to keep the test coverage report up to date.
Use when creating, updating, or maintaining AI documentation files (AGENTS.md, CLAUDE.md, skills). Covers file structure, conventions, and guidelines for evolving AI context.
| name | codebase |
| description | Use when understanding the build system, modifying CLI commands, working with isobuild, or navigating the tools/ directory. Covers build pipeline flow and file locations. |
Meteor's build system (Isobuild) and CLI structure.
Meteor is a full-stack JavaScript platform with:
/packages/tools/isobuild/tools/clitools/cli/main.js) → parses commandsproject-context.js) → resolves packages, dependenciestools/isobuild/)
bundler.js) → orchestrates buildcompiler.js) → compiles packageslinker.js) → wraps modulesstar.json, programstools/runners/) → run-app.js, run-mongo.js, run-hmr.jstools/
├── cli/ # Command-line interface
├── isobuild/ # Build system core
├── packaging/ # Package management
├── runners/ # App execution engines
├── fs/ # File system utilities
├── cordova/ # Mobile/Cordova support
├── static-assets/ # Project templates
└── project-context.js # Dependency resolution
tools/cli/)| File | Description |
|---|---|
main.js | Entry point, command dispatcher |
commands.js | Main command implementations |
commands-packages.js | Package management commands |
commands-cordova.js | Cordova/mobile commands |
Commands: meteor create, run, build, deploy, add/remove, mongo, shell
tools/isobuild/)| File | Description |
|---|---|
bundler.js | High-level bundling orchestration |
compiler.js | Package compilation |
linker.js | Module wrapping and linking |
import-scanner.ts | Import statement parsing |
compiler-plugin.js | Compiler plugin API |
isopack.js | Package format handling |
tools/runners/)| File | Description |
|---|---|
run-app.js | Web application runner |
run-mongo.js | MongoDB server runner |
run-hmr.js | Hot module reload runner |
run-all.js | Multi-runner orchestration |
| Target | Description |
|---|---|
web.browser | Modern browsers |
web.browser.legacy | Legacy browsers (IE11) |
web.cordova | Cordova mobile apps |
server | Node.js server |
tools-core → rspack, future integrationsaccounts-base → all accounts-* packagesddp-server + ddp-client → realtime communicationmongo → minimongo (client-side)webapp → all HTTP handlingVia meteor create --<template>: react, vue, svelte, angular, blaze, typescript, tailwind, solid, apollo, minimal, bare, full
| Variable | Purpose |
|---|---|
METEOR_PROFILE | Build profiling |
METEOR_PACKAGE_DIRS | Additional package paths |
METEOR_DEBUG_BUILD | Verbose build output |
package.js name, run meteor resetarchMatching, file extensions.meteor/local/, run meteor npm install