bd-css

A simple package to create themes for BetterDiscord.

Usage

Requirements:

• BunJS v1.0 or above.

Install the package:

bun add bd-css

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

/** @type {import('bd-css/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-css command followed by the script you wish to use.

bd-css dev # will build to your BetterDiscord themes folder.

bd-css build # will build the necessary files to distribute your theme relative to the project directory.

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

Why

Making a Discord theme is simply enough but trying to build a "maintainable" theme when using regular CSS can get really messy.

This package utilizes LightningCSS which allows for local imports, meaning files can be split for better organization the theme.

While you can use this package by itself, I recommend you use my create-bd-theme cli to scaffold the necessary files and structure for you.