Add migration guides and package READMEs#338
Open
deanmarano wants to merge 9 commits intosalsify:standalone-template-transformfrom
Open
Add migration guides and package READMEs#338deanmarano wants to merge 9 commits intosalsify:standalone-template-transformfrom
deanmarano wants to merge 9 commits intosalsify:standalone-template-transformfrom
Conversation
Add setup instructions for v2 apps and addons, document config options (pathMapping, runtimeModule), usage examples for static, dynamic, and mixed class names, and a brief explanation of how the compile-time transform works.
Add explanation of what the plugin does (with before/after example), setup instructions for v2 addon rollup configs, and documentation for all three config options (include, generateScopedName, getOutputFilename).
Replace the HTML comment hiding the full documentation with a <details> element so it's still visible but collapsed by default, given the package is in maintenance mode.
Describe compatibility at each stage: ember-css-modules works with classic builds and Embroider+Webpack but not Vite, so the build pipeline migration and CSS Modules swap can be done separately.
Break out steps that can be done incrementally while still on ember-css-modules: consolidate to colocated layout, rename to .module.css, remove legacy config options, migrate PostCSS config.
Break out steps that can be done while still a v1 addon: consolidate to colocated layout and rename to .module.css. Converting-to-v2 steps now account for whether prep was already done.
Cover the common case of apps using SCSS via PostCSS plugins with ember-css-modules, and how to migrate to Vite's native Sass support.
RobbieTheWagner
approved these changes
Feb 23, 2026
Contributor
RobbieTheWagner
left a comment
RobbieTheWagner
left a comment
There was a problem hiding this comment.
This looks great to me! Thanks for taking the time to write this up @deanmarano.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
ember-css-modulesto the standalone packages (glimmer-local-class-transform,rollup-plugin-preprocess-css-modules)glimmer-local-class-transformandrollup-plugin-preprocess-css-modulesember-css-modulesREADME docs expandableember-css-modulesdeprecation noticeMigration guides
Both guides include preparation steps that can be done incrementally before the final migration:
docs/MIGRATING-V1-APP.md): Staged path from classic Broccoli → Embroider+Webpack → Embroider+Vite, with prep steps (colocate files, rename to.module.css, remove legacy config, migrate PostCSS). Includes a dedicated section for apps using SCSS via PostCSS plugins.docs/MIGRATING-V1-ADDON.md): Prep steps while still v1 (colocate files, rename to.module.css), then v2 conversion stepsTest plan