ember-codemod-pod-to-octane

Codemod to un-pod Ember apps, addons, and engines

Features

• Preserves your code whenever possible
• Supports ember-css-modules

Usage

Step 1. Quickly return to default Octane.¹

cd <path/to/your/project>
npx ember-codemod-pod-to-octane <arguments>

Step 2. Remove podModulePrefix from config/environment.js and usePods from .ember-cli.

Step 3. Update references originating from, as well as pointing to, the moved files. These can include import statement, composes property from ember-css-modules, etc.

^{1. By default, Octane assumes the flat component structure. So does this codemod to help different Ember projects converge to one layout. If you want the nested component structure (also supported by Octane), you can run ember-flat-to-nested afterwards.}

Arguments

You must pass --type to indicate what type of project you have.

npx ember-codemod-pod-to-octane --type app
npx ember-codemod-pod-to-octane --type addon
npx ember-codemod-pod-to-octane --type engine

Optional: Do a test run

Pass --test to preview how the codemod will move files.

npx ember-codemod-pod-to-octane --test

Optional: Specify the project root

Pass --root to run the codemod on a project somewhere else (i.e. not in the current directory).

npx ember-codemod-pod-to-octane --root <path/to/your/project>

Note, you can use --root to un-pod the demo app of an Ember addon.

# If the current directory is the addon root
npx ember-codemod-pod-to-octane --type app --root tests/dummy

Optional: Specify the pod path

Pass --pod-path if podModulePrefix has been set in config/environment.js. "Subtract" modulePrefix from podModulePrefix to get the pod path.

# If modulePrefix is 'my-app' and podModulePrefix is 'my-app/pods'
npx ember-codemod-pod-to-octane --pod-path pods

Limitations

The codemod is designed to cover typical uses of an Ember app, addon, and engine. It is not designed to cover one-off cases.

Apps

To account for a bug (found when Ember CLI is combined with Ember Data), the codemod doesn't consider unit tests for adapters, models, and serializers. You will need to manually move the test files.

Addons

The codemod assumes that an addon is used to define components (not models or routes).

Engines

The codemod assumes that an engine is used to define routes and route-specific components.

To better meet your needs, consider cloning the repo and running the codemod locally.

cd <path/to/cloned/repo>

# Compile TypeScript
pnpm build

# Run codemod
./dist/bin/ember-codemod-pod-to-octane.js --root <path/to/your/project>

Compatibility

• Node.js v18 or above

Contributing

See the Contributing guide for details.

If you have an open-sourced app or addon that I can use as a reference, reach out to me on Discord at ijlee2. Please star this project so that I can gauge its importance to you and the Ember community. ⭐

License

This project is licensed under the MIT License.