Building from Source

If you need to build SudoCord from source — for development, for user plugins, or just because you prefer it — follow these steps:

Prerequisites

Before starting, ensure you have the following dependencies installed:

• Git
• Node.js LTS

Install pnpm

WARNING

Windows users: Do not run the following commands in an administrator terminal. This can break your Discord installation.

npm i -g pnpm

Clone the Repository

WARNING

Do not clone in your system folder. Clone in a folder you will remember, like your Documents folder.

Windows:

cd "%USERPROFILE%/Documents"

Linux or MacOS:

cd "$HOME/Documents"

git clone https://github.com/Ernest1101/Sudocord
cd Sudocord

Install Dependencies

pnpm install --no-frozen-lockfile

Discord Desktop

Build

pnpm build

TIP

To enable Developer-only plugins and access debugging tools like PatchHelper, build in Development Mode using the --dev flag:

pnpm build --dev

TIP

If you are actively making changes to the source code, use Watch Mode. This automatically triggers a rebuild every time you save a file:

pnpm build --watch
# Or for dev mode with watch:
pnpm build --dev --watch

Inject and Start

Run the injector to patch your Discord installation, then start Discord normally:

pnpm inject

Updating

To pull the latest changes and rebuild:

git fetch origin
git reset --hard origin/main
pnpm build

Then restart Discord. If your copy was installed via the Sudotl setup, you can also just press the update button in the Discord header bar — SudoCord updates itself.

Web Browser

Build

pnpm buildWeb

TIP

To enable Developer-only plugins and access debugging tools like PatchHelper, build in Development Mode using the --dev flag:

pnpm buildWeb --dev

Install

After building, you will find the output files inside the dist/ folder. Pick the one that matches your browser:

• extension-chrome.zip — For Chrome and Chromium-based browsers. Go to chrome://extensions, enable Developer Mode, and drag the zip file into the window.
• extension-firefox.zip — For Firefox. Go to about:addons, click the gear icon, and select Install Add-on From File....
• Vencord.user.js — Userscript for Tampermonkey, Greasemonkey, or any other userscript manager. Open the file in your browser and your userscript manager will prompt you to install it.