bd-scss

Simple package to create themes for BetterDiscord using SCSS.

I highly recommend using the CLI I built has it does all the instructions for you: gibbu/create-bd-theme

Usage

Install the package with:

npm install bd-scss
# or
yarn add bd-scss
# or
pnpm add bd-scss

Then create a bd-scss.config.js file in the root of your project folder with the following:

/** @type {import('bd-scss/lib/config').Config} */
export default {
	meta: {
		name: 'Cooltheme',
		author: 'Gibbu',
		version: '1.0.0',
		description: 'My cool theme',
		source: 'https://github.com/Gibbu/Cooltheme',
	},
};

And then use the bd-scss command followed by the script you wish to use.

bd-scss dev # will build to your BetterDiscord themes folder or if you've provided a path in the dev option.

bd-scss build # will build the necessary files to distribute your theme.

NOTE: Make sure you have "type": "module" set in your package.json.

Compiler API

| Property | Type | Required | Description | | ------------ | -------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | meta | Object | true | The BetterDiscord theme/plugin META. View all avaiable meta HERE | | dev | Object | false | The target and output path of the dev file. | | dist | Object | false | The target and output path of the dist file. | | base | Object | false | The target and output path of the base file. | | fileName | string | false | The name of the file to be compiled. This will default to your meta.name if this option is not provided. | | addons | ([string, string])[] | false | Any addons that should be compiled separately from your theme files. | | baseImport | string | false | The @import url used in the .theme.css file. |

All dev, dist, and base objects contain a target and output properties, and are relative to the project directory.
Execpt of the dev.output, that is an absolute path allowing you to change the location of the BetterDiscord themes folder.

Example: C:\Users\Gibbu\AppData\Roaming\BetterDiscord\themes

Examples

• DiscordStyles/SoftX
• DiscordStyles/Slate

License

See the LICENSE file for license rights and limitations (MIT).