OpenParable
Skip to content
← Back to skills

Codebase

Development
codebase

Codebase is an Agent Skill for development published in the meteor/meteor repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when understanding the build system, modifying CLI commands, working with isobuild, or navigating the tools/ directory. Covers build pipeline flow and file locations.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/meteor/meteor/blob/HEAD/.github/skills/codebase/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/codebase, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Codebase

Meteor's build system (Isobuild) and CLI structure.

Overview

Meteor is a full-stack JavaScript platform with:

  • Core packages in /packages
  • Build system (Isobuild) in /tools/isobuild
  • CLI tool in /tools/cli
  • Real-time data layer via DDP
  • Mobile support via Cordova

Build Pipeline

  1. CLI (tools/cli/main.js) → parses commands
  2. Project Context (project-context.js) → resolves packages, dependencies
  3. Isobuild (tools/isobuild/)
    • Bundler (bundler.js) → orchestrates build
    • Compiler (compiler.js) → compiles packages
    • Linker (linker.js) → wraps modules
    • Build plugins (Babel, TypeScript, CSS)
  4. Output → star.json, programs
  5. Runners (tools/runners/) → run-app.js, run-mongo.js, run-hmr.js
  6. Live App → DDP Server ↔ Minimongo ↔ UI

Directory Structure

tools/
├── 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

CLI (tools/cli/)

FileDescription
main.jsEntry point, command dispatcher
commands.jsMain command implementations
commands-packages.jsPackage management commands
commands-cordova.jsCordova/mobile commands

Commands: meteor create, run, build, deploy, add/remove, mongo, shell

Isobuild (tools/isobuild/)

FileDescription
bundler.jsHigh-level bundling orchestration
compiler.jsPackage compilation
linker.jsModule wrapping and linking
import-scanner.tsImport statement parsing
compiler-plugin.jsCompiler plugin API
isopack.jsPackage format handling

Runners (tools/runners/)

FileDescription
run-app.jsWeb application runner
run-mongo.jsMongoDB server runner
run-hmr.jsHot module reload runner
run-all.jsMulti-runner orchestration

Build Targets

TargetDescription
web.browserModern browsers
web.browser.legacyLegacy browsers (IE11)
web.cordovaCordova mobile apps
serverNode.js server

Package Relationships

  • tools-core → rspack, future integrations
  • accounts-base → all accounts-* packages
  • ddp-server + ddp-client → realtime communication
  • mongo → minimongo (client-side)
  • webapp → all HTTP handling

Project Templates

Via meteor create --<template>: react, vue, svelte, angular, blaze, typescript, tailwind, solid, apollo, minimal, bare, full

Environment Variables

VariablePurpose
METEOR_PROFILEBuild profiling
METEOR_PACKAGE_DIRSAdditional package paths
METEOR_DEBUG_BUILDVerbose build output

Troubleshooting

  • Package not found: Check package.js name, run meteor reset
  • Build plugin not running: Check archMatching, file extensions
  • npm issues: Clear .meteor/local/, run meteor npm install