Fix #3729

docs/_data/links.json

@@ -293,6 +293,13 @@
       "icon": "fab fa-sass",
       "path": "/documentation/customize/with-sass/"
     },
+    "customize-with-modular-sass": {
+      "name": "With Modular Sass",
+      "subtitle": "Import <strong>only</strong> what you need and <strong>customize</strong> it",
+      "color": "sass",
+      "icon": "fas fa-cubes",
+      "path": "/documentation/customize/with-modular-sass/"
+    },
     "customize-with-css-variables": {
       "name": "With CSS Variables",
       "subtitle": "See how Bulma uses <strong>Sass variables</strong> to allow easy customization",
@@ -793,6 +800,7 @@
     "customize": [
       "customize-concepts",
       "customize-with-sass",
+      "customize-with-modular-sass",
       "customize-with-css-variables",
       "customize-sass-list"
     ],

docs/_sass/examples/custom.scss

@@ -1,22 +1,41 @@
-@use "sass:color";
-
 // Set your brand colors
 $purple: #8a4d76;
 $pink: #fa7c91;
 $brown: #757763;
 $beige-light: #d0d1cd;
 $beige-lighter: #eff0eb;
 
-// Path to Bulma's sass folder
-@use "sass" with (
+// Override global Sass variables from the /utilities folder
+@use "sass/utilities" with (
   $family-primary: '"Nunito", sans-serif',
   $grey-dark: $brown,
   $grey-light: $beige-light,
   $primary: $purple,
   $link: $pink,
-  $control-border-width: 2px,
+  $control-border-width: 2px
+);
+
+// Override Sass variables from the /form folder
+@use "sass/form" with (
   $input-shadow: none
 );
 
+// Import the components you need
+@forward "sass/base";
+@forward "sass/components/card";
+@forward "sass/components/modal";
+@forward "sass/components/navbar";
+@forward "sass/elements/button";
+@forward "sass/elements/button";
+@forward "sass/elements/icon";
+@forward "sass/elements/content";
+@forward "sass/elements/notification";
+@forward "sass/elements/progress";
+@forward "sass/elements/tag";
+@forward "sass/layout/footer";
+
+// Import the themes so that all CSS variables have a value
+@forward "sass/themes";
+
 // Import the Google Font
 @import url("https://fonts.googleapis.com/css?family=Nunito:400,700");