Plan before making changes
Dry-run behavior makes intended migrations inspectable before files are changed. Conflict detection identifies places where generated updates and application changes need deliberate handling.
Back to selected work01 02
ENGINEERING CASE STUDY / OPEN SOURCE · DEVELOPER TOOLING
create-fsd-architecture.
Open Source Contribution — Safe Project Upgrades
Helping a frontend architecture CLI upgrade projects safely, with migration planning, conflict detection and rollback.
MY ROLE
Open source contributor
upgrade-workflow~/my-project
# Preview the migration before changing files
$ npx create-fsd-architecture upgrade --dry-run
InspectPlanDetect conflicts
# Check the project’s upgrade readiness
$ npx create-fsd-architecture upgrade --check
ValidateRecover safely
Illustrative commands · safe upgrade workflow
The challenge
A project upgrade can overwrite application code when tooling cannot distinguish generated files from user changes. Safe upgrades need a plan, conflict handling and a recovery path.
My contribution
I contributed a migration workflow to the existing create-fsd-architecture CLI. It inspects a project, plans changes, detects conflicts, validates the result and supports rollback instead of blindly re-scaffolding application files.
02 / ARCHITECTURE & TECHNICAL DECISIONS
Engineering with intent.
Validate and recover
Validation and rollback paths make failure handling part of the migration workflow. Automated tests cover migration safety.
03 / KEY FEATURES & ENGINEERING HIGHLIGHTS
From architecture to everyday use.
- Migration planning and dry-run behavior
- Conflict detection and handling
- Safe migration workflow
- Validation of migration outcomes
- Rollback paths
- Automated migration-safety tests
Technology stack
Node.js · CLI tooling · Feature-Sliced Design · Automated tests
04 / MIGRATION WORKFLOW
Safety at each step.
01Inspect
02Plan
03Conflict Detection
04Safe Migration
05Validate
06Rollback
Rollback provides a recovery path when validation fails. This is a contribution to an existing open source project.
NEXT CASE STUDY
Wasla AI
AI WhatsApp Operating System for Businesses
06 /LET’S BUILD SOMETHING
Complex challenges.
Thoughtful solutions.
Looking for a senior engineer who cares about the interface
and the system behind it? Let’s talk.
Open to remote opportunitiesCairo, Egypt