marko-migrate

library1.2.7jsnpmunverified

A CLI tool that migrates Marko v2 projects to be compatible with Marko v3. Version 1.2.7 is the latest stable release. This tool automatically updates taglibs and templates in a project (excluding node_modules) and modifies package.json dependency versions. It requires Node.js v4+ and should be run after an npm install. Key differentiator: it handles both HTML and concise syntax migration, and provides clear output of modified files and pending tasks for installed packages that also need migration. Note: it modifies files in place, so source control is strongly recommended before use.

devops

npm install marko-migrate

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MARKO-MIGRATE

marko-migrate

devopsjavascriptv1.2.7

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Installs the migration tool globally and runs it on a Marko v2 project to migrate to Marko v3 using HTML syntax.

npm install marko-migrate --global cd my-project/ marko-migrate --syntax html

Debug

Known issues

breakingThis tool modifies files in place without backup; always commit changes first.

fix

Use source control (e.g., git commit) before running marko-migrate.

affects: >=1.0.0

breakingRequires Node.js v4+; older versions will fail to execute.

fix

Upgrade Node.js to v4 or higher.

affects: >=1.0.0

gotchaMust run 'npm install' before migration; otherwise dependency updates may fail.

fix

Run 'npm install' in your project before executing marko-migrate.

affects: >=1.0.0

deprecatedMarko has moved beyond v3; this tool is only useful for legacy v2 to v3 migrations.

fix

Consider using newer Marko migration tools or manually updating to latest Marko version.

affects: >=1.0.0

Errors

Common errors & fixes

marko-migrate: command not found

Global installation not completed or not in PATH

fix

Ensure npm install marko-migrate --global succeeded and check your PATH environment variable.

Error: Node.js v4+ is required

Running on an older Node.js version

fix

Install Node.js v4 or higher (e.g., using nvm).

ENOENT: no such file or directory, open '.../package.json'

Running marko-migrate outside a valid project root

fix

Change to the project directory that contains a package.json file.

Upgrade

Version history

1.2.7latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

9 hits · last 30 days

node

Resources

githubhttps://github.com/marko-js/marko-migrate ↗

packagemarko-migrate ↗

homepagehttps://github.com/marko-js/marko-migrate#readme ↗