| name | modern-tools |
| description | Use when working with tools-core utilities, rspack integration, or modern tooling. Covers logging, npm management, process spawning, git helpers, and Meteor app configuration APIs. |
Modern Tools
Utility packages for modern tooling, bundler integrations, and native solutions.
tools-core (/packages/tools-core)
Central utility package providing helpers for npm, logging, process management, and Meteor configuration. This is the foundation for modern tool integrations.
Logging Module (lib/log.js)
import { logProgress, logError, logInfo, logSuccess } from 'meteor/tools-core';
logProgress('Building application...');
logSuccess('Build complete');
logError('Build failed');
logInfo('Using Rspack bundler');
Respects METEOR_DISABLE_COLORS environment variable.
NPM Management Module (lib/npm.js)
| Function | Description |
|---|
getNodeBinaryPath(binaryName) | Gets path to Node binaries (npm, npx, node) |
checkNpmDependencyExists(dep, opts) | Checks if npm package is installed |
checkNpmBinaryExists(binary, opts) | Checks if binary exists in node_modules/.bin |
checkNpmDependencyVersion(dep, opts) | Validates semver with conditions (gte, lt, eq) |
installNpmDependency(deps, opts) | Installs dependencies (npm/yarn, dev/exact flags) |
getNpmCommand(args) | Returns npm command with meteor npm fallback |
getNpxCommand(args) | Returns npx command with meteor npx fallback |
getYarnCommand(args) | Gets yarn command path |
isYarnProject(opts) | Detects yarn projects (yarn.lock, packageManager) |
getMonorepoPath(opts) | Detects monorepo root (workspaces, lerna, pnpm) |
isMonorepo(opts) | Boolean monorepo detection |
Process Management Module (lib/process.js)
| Function | Description |
|---|
spawnProcess(cmd, args, opts) | Spawns process with streaming output, color preservation |
stopProcess(proc, opts) | Graceful termination with SIGTERM/SIGKILL fallback |
isProcessRunning(proc) | Checks if process is still running |
isPortAvailable(port, host) | Checks if port is free |
waitForPort(port, opts) | Waits for port availability with timeout |
Options for spawnProcess: env, cwd, detached, onStdout, onStderr, onExit, onError
Meteor Configuration Module (lib/meteor.js)
Application Configuration:
| Function | Description |
|---|
getMeteorAppDir() | Gets application root directory |
getMeteorAppPackageJson() | Parses app's package.json |
getMeteorAppConfig() | Retrieves Meteor config from package.json or Plugin |
getMeteorAppPort() | Gets app port from environment |
getMeteorAppConfigModern() | Gets modern bundler configuration |
isMeteorAppConfigModernVerbose() | Checks verbose flag |
hasMeteorAppConfigAutoInstallDeps() | Auto-install deps flag |
Entry Points:
| Function | Description |
|---|
getMeteorAppEntrypoints() | Gets main/test modules for client/server |
getMeteorInitialAppEntrypoints() | Gets initial entry points with HTML detection |
isMeteorAppTestModule() | Checks if project is test module |
setMeteorAppEntrypoints(opts) | Sets entry points via environment variables |
setMeteorAppIgnore(pattern) | Sets file ignore patterns |
setMeteorAppCustomScriptUrl(url) | Sets custom script URLs |
Command Detection:
| Function | Description |
|---|
isMeteorAppRun() | Running in 'run' mode |
isMeteorAppBuild() | Running in 'build' or 'deploy' |
isMeteorAppUpdate() | Running in 'update' |
isMeteorAppTest() | In test mode |
isMeteorAppTestFullApp() | Test mode with full-app flag |
isMeteorAppTestWatch() | Test mode in watch mode |
isMeteorAppNativeAndroid() | Native Android mode |
isMeteorAppNativeIos() | Native iOS mode |
isMeteorAppNative() | Any native mode |
isMeteorAppDevelopment() | Development mode |
isMeteorAppProduction() | Production mode |
isMeteorAppDebug() | Debug mode |
Package Detection:
| Function | Description |
|---|
isMeteorBlazeProject() | Has blaze/blaze-html-templates |
isMeteorBlazeHotProject() | Blaze with hot reload |
isMeteorCoffeescriptProject() | Has CoffeeScript |
isMeteorLessProject() | Has Less CSS |
isMeteorScssProject() | Has SCSS/Sass |
isMeteorTypescriptProject() | Has TypeScript |
isMeteorBundleVisualizerProject() | Has bundle visualizer |
isMeteorPackagesTest() | test-packages command |
File Operations:
| Function | Description |
|---|
getMeteorAppFilesAndFolders(opts) | Scans app directory (recursive, with ignore) |
getMeteorAppPackages() | Lists all loaded packages |
getMeteorEnvPackageDirs() | Gets package directories from env vars |
getMeteorToolsRequire(filePath) | Requires module relative to Meteor tools |
Global State Module (lib/global-state.js)
Maintains persistent state across file changes during development:
import { getGlobalState, setGlobalState, removeGlobalState, clearGlobalState } from 'meteor/tools-core';
setGlobalState('buildStartTime', Date.now());
const startTime = getGlobalState('buildStartTime');
Git Management Module (lib/git.js)
| Function | Description |
|---|
isGitRepository(dir) | Checks if directory is git repo |
gitignoreExists(dir) | Checks .gitignore existence |
ensureGitignoreExists(dir, entries) | Creates .gitignore with initial entries |
getMissingGitignoreEntries(dir, entries) | Finds missing entries |
addGitignoreEntries(dir, entries, ctx) | Adds entries with context logging |
String Utilities (lib/string.js)
| Function | Description |
|---|
capitalizeFirstLetter(str) | Capitalizes first character |
shuffleString(str) | Shuffles string characters |
joinWithAnd(items, opts) | Human-readable list ("a, b, and c") |
Rspack Integration (/packages/rspack)
Modern bundler integration using Rspack (Rust-based Webpack alternative).
Package Structure
| File | Description |
|---|
lib/constants.js | Default versions, global state keys, build contexts |
lib/dependencies.js | Dependency checking and auto-installation |
lib/build-context.js | Build directory management |
lib/config.js | Meteor configuration for Rspack |
lib/processes.js | Rspack process spawning |
lib/compilation.js | Compilation tracking |
Build Contexts
| Context | Directory | Purpose |
|---|
RSPACK_BUILD_CONTEXT | _build | Build output |
RSPACK_ASSETS_CONTEXT | build-assets | Static assets |
RSPACK_CHUNKS_CONTEXT | build-chunks | Chunk bundles |
RSPACK_DOCTOR_CONTEXT | .rsdoctor | Analysis/diagnostics |
Key Dependencies
@rspack/core ^1.7.1@meteorjs/rspack ^2.1.0 (configuration logic)@rspack/plugin-react-refresh ^1.4.3swc-loader ^0.2.6
Integration with tools-core
- Uses
getMeteorInitialAppEntrypoints() for entry points
- Uses command detection functions for build mode awareness
- Uses process spawning and npm utilities
TypeScript Compiler (/packages/typescript)
Compiler plugin for TypeScript/TSX file compilation.
Registered Plugin: compile-typescript
Supported Extensions: .ts, .tsx
Implied Packages: modules, ecmascript-runtime, babel-runtime, promise, dynamic-import
Features:
- Transpiles TypeScript before Babel processing
- Supports client/server/legacy browser targets
- Integrates with React Fast Refresh for HMR
Limitations:
- Per-file transpilation (no cross-file type analysis)
- No tsconfig.json support (Meteor manages settings)
- No type checking during compilation
- No .d.ts generation
WebApp & Express (/packages/webapp)
HTTP server integration using Express.js 5.x framework.
Key APIs
import { WebApp } from 'meteor/webapp';
WebApp.connectHandlers.use('/api', myMiddleware);
WebApp.handlers.use(compression());
WebApp.expressApp.get('/health', (req, res) => res.send('OK'));
WebApp.httpServer;
WebApp.onListening(() => console.log('Server ready'));
Express Exports
| Property | Description |
|---|
WebApp.connectHandlers | Express middleware registry (legacy name) |
WebApp.handlers | Current middleware registry |
WebApp.rawConnectHandlers | Raw Express handlers |
WebApp.expressApp | Direct Express app instance |
WebApp.httpServer | HTTP server instance |
WebApp.express | Express module export |
Dependencies: express@5.1.0, cookie-parser@1.4.6, compression@1.7.4, errorhandler@1.5.1
