1. Introduction
Sam4Sc is a migration assistant for Angular to SCAM (Single Angular Component Modules) and Standalone Components.
Migrating an Angular application to the SCAM model is a preparation for the final switch to Standalone Components.
Sam4Sc assists in both steps, whereas the migration from SCAM to Standalone Components is fully automatic.
The migration/generation of SCAMs is semi-automatic. The SCAMs a generated first. After that, the developer(s) must define the dependencies per SCAM manually.
2. Setup and Usage
To install Sam4Sc, execute
npm i -D @angular-architects@sam4sc
2.1. Generate SCAMs
npx ng generate @angular-architects/sam4sc:scam --dry-run
# make sure, everything looks alright
npx ng generate @angular-architects/sam4sc:scam
or alternatively,
npx ng generate @angular-architects:sam4sc:scam --project [projectName]
2.2. Show the progress report for the SCAM report
npx ng generate @angular-architects/sam4sc:report
SCAMs will have a JavaScript comment at the start of the file with a tag SAM4SC:SCAM. Remove those, if you have added the dependencies and that module will not show up in the progress report.
2.3. Migrate to Standalone Components (Beta)
npx ng generate @angular-architects/sam4s:scam2sc
Please feel free to try it out and give feedback.
3. More information
- Detailed Explanation of SCAM, by Lars Gyrup Brink Nielsen
- RFC Standalone Components
- Standalone Components and their Impact on Modularity, by Rainer Hahnekamp
Angular Architects: Angular Content, Consultancy, Training
