Skip to content
stackchainstackchain

Smart merge and regeneration

Markers

Section titled “Markers”
// <stackchain:routes>
// generated
// </stackchain:routes>

Known IDs: routes, core, features.

Engines

Section titled “Engines”
Component Role
RegionMerger Replace region bodies only
SmartFileMerger Merge missing Dart imports
ProjectSync Router + DI sync entrypoint

Commands that merge

Section titled “Commands that merge”
  • sync
  • feature / add
  • upgrade
  • migrate
  • make page (auto-sync)

Overwrite vs merge

Section titled “Overwrite vs merge”
Flag / mode Effect
default write Skip existing files
--overwrite / -f Replace whole files
region merge Replace only marker interiors

Best practice

Section titled “Best practice”

Never hand-edit inside markers if you plan to re-sync. Add companion methods, wrappers, or unmarked sections instead.