ksungz
Engineering

Dart Sass 마이그레이션

모바일웹 정적 리소스 프로젝트의 전체 SCSS 파일을 node-sass에서 Dart Sass로 마이그레이션

Dart Sass (sass-embedded)GulpNode.js

담당 업무

모바일웹 정적 리소스 프로젝트의 전체 SCSS 파일을 node-sass에서 Dart Sass로 마이그레이션했습니다. CSS 산출물 변경을 최소화하면서 단계적으로 전환한 대규모 작업입니다.

주요 성과

  • 전체 SCSS 파일을 폴더별 단계적으로 전환하며 CSS 산출물 변경을 최소화
  • 빌드 설정 수정(foundation 경로, SVG sprite 최신화), watch 기능 이슈 해결
  • 완료 후 정적 리소스 저장소에도 동일 작업 적용하여 팀 전체 SCSS 환경 통일

상세 작업 내역

기간작업내용
2025.06 ~ 07전체 SCSS 문법 전환약 2주간 폴더별 단계적 진행. 전체 SCSS 파일 대상 Dart Sass 문법으로 전환
2025.06 ~ 07CSS 산출물 일관성 확보node-sass 대비 변경내역 최소화. 백업 파일 관리 및 머지 테스트
2025.07빌드 설정 수정foundation 경로 수정, 따옴표 동기화, SVG sprite 최신화
2025.07watch 기능 이슈 해결공통 SCSS 변경 시 빌드 안 되는 현상 수정
2025.07 ~정적 리소스 저장소 적용Dart Sass 전환 후 정적 리소스 저장소에도 동일 문법 전환 작업 수행

관련 문서

DartSass 전환 회고 (with Cursor AI) — Cursor AI를 활용한 대규모 마이그레이션 (2,384개 파일, 3주) 경험 공유 문서