Skip to content

feat!: remove deprecated scss mixins and variables#3340

Draft
aresnik11 wants to merge 7 commits into
mainfrom
ajr-scss-mixins-clean-up
Draft

feat!: remove deprecated scss mixins and variables#3340
aresnik11 wants to merge 7 commits into
mainfrom
ajr-scss-mixins-clean-up

Conversation

@aresnik11
Copy link
Copy Markdown
Contributor

@aresnik11 aresnik11 commented May 4, 2026

Overview

Remove legacy @codecademy/gamut-styles SCSS utilities

This branch deletes the shared SCSS “utils” layer from gamut-styles: functions, mixins, variable partials, and the barrel files that forwarded them. core/_reboot.scss is updated so core still works without the old variable/mixin pipeline.

Downstream impact: Any app or package that did @use "~@codecademy/gamut-styles/utils" (or relied on those mixins / SCSS color grids / responsive helpers) must either be updated to use the plain CSS values, add a shared utils in the app/package for the mixins/variables needed, or refactored to use the equivalent TypeScript / Emotion APIs.

Gamut components still on SCSS

Remaining SCSS in Gamut that used the removed utils is rewritten to plain CSS values (or self-contained rules), including:

  • AccordionButtonDeprecated (and ButtonDeprecated under it): variables.scss, mixins.scss, and index.module.scss updated so they no longer depend on removed gamut-styles SCSS.
  • Video (vds_base_theme.scss): remove px-rem function in alignment with the cleanup.
  • Typography / _variables.scss: removed where it was only supporting the old SCSS token path.

Docs

  • Utilities.mdx: SCSS examples (px-rem, @include box-shadow, @include font-smoothing, etc.) removed; headings emphasize TS-only helpers (pxRem, boxShadow, fontSmoothing, …).
  • gamut-styles README: trimmed to match the new surface area.

PR Checklist

Testing Instructions

Don't make me tap the sign.

  1. Confirm all checks pass and the code and storybook builds
  2. Confirm Utilities SB page makes sense with changes
  3. Confirm Accordion still looks as expected
  4. Follow testing instructions within mono and monolith PRs
  5. Finish and do a celebratory dance

PR Links and Envs

Repository PR Link
Monolith Monolith PR
Mono Mono PR

@nx-cloud
Copy link
Copy Markdown

nx-cloud Bot commented May 4, 2026

View your CI Pipeline Execution ↗ for commit 9111a25


☁️ Nx Cloud last updated this comment at 2026-05-11 18:56:33 UTC

@codecov
Copy link
Copy Markdown

codecov Bot commented May 4, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.91%. Comparing base (a4a4da7) to head (9111a25).
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #3340      +/-   ##
==========================================
- Coverage   90.40%   89.91%   -0.50%     
==========================================
  Files         405      276     -129     
  Lines        6649     5730     -919     
  Branches     2125     1933     -192     
==========================================
- Hits         6011     5152     -859     
+ Misses        630      570      -60     
  Partials        8        8              
Flag Coverage Δ
main ?
pull-request 89.91% <ø> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@codecademydev
Copy link
Copy Markdown
Collaborator

📬 Published Alpha Packages:

Package Version npm Diff
@codecademy/gamut 68.5.2-alpha.5193c7.0 npm diff
@codecademy/gamut-icons 9.57.5-alpha.5193c7.0 npm diff
@codecademy/gamut-illustrations 0.58.11-alpha.5193c7.0 npm diff
@codecademy/gamut-kit 0.6.598-alpha.5193c7.0 npm diff
@codecademy/gamut-patterns 0.10.30-alpha.5193c7.0 npm diff
@codecademy/gamut-styles 17.14.1-alpha.5193c7.0 npm diff
@codecademy/gamut-tests 6.0.1-alpha.5193c7.0 npm diff
@codecademy/variance 0.26.2-alpha.5193c7.0 npm diff
eslint-plugin-gamut 2.4.4-alpha.5193c7.0 npm diff

@github-actions
Copy link
Copy Markdown
Contributor

@aresnik11 aresnik11 changed the title remove a whole bunch of scss feat!: remove deprecated scss mixins and variables May 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants