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
 ===============
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"