Sass Handling

Learn how to use Sass/SCSS in GenGen with the _sass directory structure, imports, and compilation.

Sass Handling in GenGen

GenGen automatically compiles .scss and .sass files using the Dart Sass compiler.

Directory Structure

your-site/
โ”œโ”€โ”€ _sass/
โ”‚   โ”œโ”€โ”€ _mixins.scss         # Reusable mixins
โ”‚   โ””โ”€โ”€ _variables.scss      # Variables
โ”œโ”€โ”€ css/
โ”‚   โ””โ”€โ”€ main.scss            # Main stylesheet
โ””โ”€โ”€ _themes/
    โ””โ”€โ”€ your-theme/
        โ””โ”€โ”€ _sass/           # Theme Sass files

Import Paths

GenGen automatically configures import paths:

  1. Site _sass/ directory
  2. Theme _sass/ directory

Usage

_sass/_mixins.scss:

@mixin border-radius($radius) {
  -webkit-border-radius: $radius;
  -moz-border-radius: $radius;
  border-radius: $radius;
}

css/main.scss:

@use "mixins" as *;

.button {
  @include border-radius(4px);
}

Configuration

sass_dir: "_sass"

Compilation

  • Input: css/main.scss
  • Output: public/css/main.css

Files in _sass/ are not compiled directly but are available for import.