From bf52cfbfa1ea59dccfaf899eea7010d11d5f37c2 Mon Sep 17 00:00:00 2001 From: "Adolfo R. Brandes" Date: Wed, 17 Dec 2025 14:32:04 -0300 Subject: [PATCH 1/2] 1.0.0-alpha.8 --- package-lock.json | 4 ++-- package.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 4cb0e64f..a9ce78dc 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@openedx/frontend-base", - "version": "1.0.0-alpha.7", + "version": "1.0.0-alpha.8", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@openedx/frontend-base", - "version": "1.0.0-alpha.7", + "version": "1.0.0-alpha.8", "license": "AGPL-3.0", "dependencies": { "@babel/core": "^7.24.9", diff --git a/package.json b/package.json index a6b35b38..d0ad763c 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@openedx/frontend-base", - "version": "1.0.0-alpha.7", + "version": "1.0.0-alpha.8", "description": "Build tools, setup and config for frontend apps", "publishConfig": { "access": "public" From 25ea7af21b177b5be9ad9ed5bcf74588df045d89 Mon Sep 17 00:00:00 2001 From: "Adolfo R. Brandes" Date: Tue, 6 Jan 2026 09:55:38 -0300 Subject: [PATCH 2/2] docs: Clarify shell scss usage in dev mode The shell's SCSS must be explicitly loaded by site.config.dev.tsx. --- docs/how_tos/migrate-frontend-app.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/docs/how_tos/migrate-frontend-app.md b/docs/how_tos/migrate-frontend-app.md index 76ec38a8..890cca7c 100644 --- a/docs/how_tos/migrate-frontend-app.md +++ b/docs/how_tos/migrate-frontend-app.md @@ -779,14 +779,21 @@ These modules should be unopinionated about the path prefix where they are mount Create an app.scss file ======================= -This is required if you intend to run builds from the app itself. +This is required for running the app in dev mode. Create a new `app.scss` file at the top of your application. It's responsible for: -1. Importing the shell's stylesheet, which includes Paragon's core stylesheet. -2. Importing the stylesheets from your application. +1. Using the shell's stylesheet, which includes Paragon's core stylesheet. +2. Using the stylesheets from your application, if any. -You must then import this new stylesheet into your `site.config` file: +For example: + +``` +@use "@openedx/frontend-base/shell/app.scss"; +@use "sass/style"; +``` + +You must then import this file from your `site.config.dev.tsx` file: ```diff + import './app.scss'; @@ -816,7 +823,7 @@ Convert @import to @use in SCSS files @import is deprecated in the most recent versions of SASS. It must be converted to @use. -If still importing Paragon SCSS variables, you will find that they, in particular, are likely to result in errors when building the app in webpack. The app should be migrated to use CSS variables from Paragon 23, as per [the corresponding howto](https://openedx.atlassian.net/wiki/spaces/BPL/pages/3770744958/Migrating+MFEs+to+Paragon+design+tokens+and+CSS+variables). These do not need to be @used by the app, as they should be loaded into the site HTML by default. +If still importing Paragon SCSS variables, you will find that they, in particular, are likely to result in errors when building the app in webpack. The app should be migrated to use CSS variables from Paragon 23, as per [the corresponding howto](https://openedx.atlassian.net/wiki/spaces/BPL/pages/3770744958/Migrating+MFEs+to+Paragon+design+tokens+and+CSS+variables). Changes to i18n ===============