# create-bd-theme

> A CLI to scaffold BetterDiscord themes.

Latest version **0.4.4** (published 2026-07-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install create-bd-theme
pnpm add create-bd-theme
yarn add create-bd-theme
bun add create-bd-theme
```

Provides the command `create-bd-theme`.

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.4.4 |
| Published | 2026-07-24 |
| First published | 2022-02-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 4 |
| Unpacked size | 9.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 11 |
| Author | Gibbu |
| Maintainers | gibbu |
| Keywords | betterdiscord, themes, scss, create-bd-theme |

## Links

- npm: https://www.npmjs.com/package/create-bd-theme
- Repository: https://github.com/Gibbu/create-bd-theme
- Homepage: https://github.com/Gibbu/create-bd-theme#readme
- Issues: https://github.com/Gibbu/create-bd-theme/issues
- npm.io page: https://npm.io/package/create-bd-theme

## Dependencies (4)

- [ncp](https://npm.io/package/ncp.md) ^2.0.0
- [execa](https://npm.io/package/execa.md) ^10.0.0
- [kleur](https://npm.io/package/kleur.md) ^4.1.5
- [@clack/prompts](https://npm.io/package/@clack/prompts.md) ^1.7.0

## Recent versions

- 0.4.4 (latest) — 2026-07-24
- 0.4.3 — 2026-07-24
- 0.4.2 — 2026-07-24
- 0.4.1 — 2026-07-24
- 0.4.0 — 2026-07-24
- 0.3.0 — 2025-03-27
- 0.2.0 — 2023-07-15
- 0.1.13 — 2023-07-01
- 0.1.12 — 2022-11-13
- 0.1.11 — 2022-09-26
- 0.1.10 — 2022-09-26
- 0.1.9 — 2022-07-27
- 0.1.8 — 2022-07-21
- 0.1.7 — 2022-06-28
- 0.1.5 — 2022-06-23
- … 15 more at https://npm.io/package/create-bd-theme/versions

## README

# create-bd-theme

A CLI to scaffold BetterDiscord themes.

<br>

## Usage

Have [BunJS](https://bun.com/docs/installation) v1.0 or above installed and then run the following command:

```bash
bunx create-bd-theme <directory name> [options]
```

This will ask a series of questions such as: Theme name, Description, your GitHub name, and if you'd like it initalize a Git repository.

<br>

> Make sure your GitHub name is correct as the CLI will use that for the GitHub Pages `@import`.  
> Providing the `--git` option will initialize a git repo and skip asking you.

<br>

Move into the newly created directory and install the dependency using:

```bash
cd MyTheme
npm install
```

<br>

Now you're able to access the `dev` and `build` scripts using:

```bash
npm run dev
# and
npm run build
```

The `dev` script will watch the the `src` folder and compile them to your BetterDiscord themes folder.  
The `build` script will compile the necessary files based off your `bd-css.config.js` config.

> **View [bd-css](https://github.com/Gibbu/bd-css) for more info.**

<br>

## Deployment

When you're ready to share your awesome theme, all you need to do is push the changes to your repository and enable GitHub pages to target the `deploy` branch.

The resulting files will look along the lines of:

> _CoolTheme.theme.css_

```css
/**
 * @name CoolTheme
 * @author CoolPerson
 * @version 1.0.0
 * @description My cool theme
 * @source https://github.com/me/CoolTheme
 */

@import url('https://coolperson.github.io/CoolTheme/CoolTheme.css');

:root {
	--theme-variable: red;
}
```

> _CoolTheme.css_

```css
#app-mount .container__2637a {
	background: var(--theme-variable);
}
```

Users will just need to download `CoolTheme.theme.css` and upon enabling the theme, Discord will fetch the `@import` contents.

---
_Source: https://npm.io/package/create-bd-theme · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._