ngxsmk-migrate

library1.2.1jsnpmunverified

ngxsmk-migrate is an AI-powered Angular migration toolkit that automates upgrades from legacy Angular patterns (NgModules, RxJS BehaviorSubjects, *ngIf/*ngFor) to modern standalone components, signals, and control flow. It integrates with Gemini 1.5, OpenAI, and Anthropic for intelligent refactoring and detailed upgrade reports. Key features include AST-based transformations, gradual migration support, and a CLI for analyzing and fixing Angular applications. Version 1.2.1 is the current stable release; updates are frequent. Differs from other migration tools (like ng generate) by using AI to understand project-specific architecture and suggest optimized replacements, not just template-based codemods.

devops

npm install ngxsmk-migrate

package ↗

INSTALL

IMPORT

SIG · NGXSMK-MIGRATE

ngxsmk-migrate

devopsjavascriptv1.2.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ngxsmk-migrate (CLI)

✓ npx ngxsmk-migrate analyze .

✗ npm install ngxsmk-migrate (local install then run)

The package is designed to be used globally via npx or global install; local install also works but CLI entry point is 'ngxsmk-migrate'.

Programmatic API

✓ const { analyze } = require('ngxsmk-migrate');

✗ import { analyze } from 'ngxsmk-migrate';

The package currently ships as CommonJS; ESM import is not supported yet. Use require() for Node.js usage.

AI Provider Configuration

✓ process.env.GOOGLE_API_KEY = '...';

✗ process.env.API_KEY = '...';

Environment variable names differ by provider: GOOGLE_API_KEY for Gemini, OPENAI_API_KEY for ChatGPT, ANTHROPIC_API_KEY for Claude. Setting the wrong variable will cause provider authentication failures.

Installs the CLI globally, sets the Gemini API key, then analyzes and fixes an Angular project for modern patterns.

npm install -g ngxsmk-migrate export GOOGLE_API_KEY="your-api-key" cd my-angular-project ngxsmk-migrate analyze . ngxsmk-migrate fix .

Debug

Known issues

gotchaThe CLI commands 'analyze' and 'fix' require network access to AI APIs. Offline usage will fail unless API keys are set and internet is available.

fix

Ensure your environment has internet access and valid API keys for the chosen AI provider.

affects: >=1.0.0

gotchaProgrammatic API is CommonJS only; using ESM import will throw 'ERR_REQUIRE_ESM' error.

fix

Use require('ngxsmk-migrate') instead of import.

affects: >=1.0.0

gotchaThe 'fix' command modifies files in place. There is no undo; backup your project before running.

fix

Run 'ngxsmk-migrate analyze .' first to review changes, or use version control.

affects: >=1.0.0

deprecatedSupport for Angular versions < 15 is deprecated and may be removed in future releases.

fix

Upgrade your Angular project to at least version 15 before using ngxsmk-migrate.

affects: >=1.0.0

gotchaRunning on large projects may hit API rate limits or token limits for the AI provider, causing incomplete migrations.

fix

Use a provider with higher rate limits (e.g., Gemini) or split the project into smaller parts.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'ngxsmk-migrate'

The package is not installed globally or locally.

fix

Install globally: npm install -g ngxsmk-migrate or use npx: npx ngxsmk-migrate

Error: API key not configured. Please set GOOGLE_API_KEY environment variable.

The AI provider requires an API key, but it is not set.

fix

Set GOOGLE_API_KEY (or OPENAI_API_KEY/ANTHROPIC_API_KEY) in your environment.

TypeError: analyze is not a function

Attempting to import the package using ESM syntax.

fix

Use CommonJS require: const { analyze } = require('ngxsmk-migrate');

Upgrade

Version history

1.2.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

packagengxsmk-migrate ↗