Run it locally

Prerequisites

Bun (the project runs TypeScript directly — no build step)
PostgreSQL 16 and Redis 7 (or just use the bundled Docker Compose)
A Discord application with a bot token

Setup

Clone and install

Install once at the workspace root — Bun resolves every app in the monorepo.

git clone https://github.com/MrDemonWolf/fluffboost.git
cd fluffboost
bun install

Start local infrastructure

docker compose up -d

This brings up PostgreSQL and Redis on localhost with the defaults the bot expects.

Configure the bot

cp apps/discord/.env.example apps/discord/.env

Fill in your Discord credentials and IDs. See Configuration for every variable.

Sync the database schema

bun run db:push

Run in watch mode

bun run dev:discord

Handy workspace scripts

Run these from the repo root — they fan out through Turborepo:

Script	What it does
`bun run dev:discord`	Bot with hot reload
`bun run dev:docs`	This docs/marketing site
`bun run test`	Test suites across the workspace
`bun run typecheck`	TypeScript checks
`bun run lint:check`	ESLint (no fixes)
`bun run db:push`	Push schema changes to the dev database
`bun run db:seed`	Load the starter quote library (safe to re-run)
`bun run db:studio`	Open Drizzle Studio

The bot uses Discord's ShardingManager: apps/discord/src/app.ts is the supervisor process that spawns shard processes running apps/discord/src/bot.ts.

On this page