Bun

Create a Server

Using the @buape/carbon/adapters/bun package, you can create a server to host your bot. This server will handle incoming interactions and route them to your bot.

import { createServer } from '@buape/carbon/adapters/bun'
 
const handle = createHandle( ... )
 
createServer(handle, { port: 3000 })

Set Environment Variables

First things first, you'll need to grab your Discord application's secrets from the Developer Portal and paste them in your .env file.

Set Up a Proxy

Discord requires a public URL to route interactions to your project. To achieve this, you'll need to set up a proxy. The simplest way to do this is by using localtunnel. Once you have the public URL, you may want to set it as BASE_URL="<PUBLIC_URL>" in your .env file.

npx localtunnel

Configure Portal URLs

Now that you have a public URL, navigate back to the Discord Developer Portal and set the "Interactions Endpoint URL" to <BASE_URL>/interactions.

Invite your App

You'll need to invite your app to your server to interact with it. To do so, navigate to the Installation tab of your app in the Discord Developer Portal.

Run the Bot

You can now run your bot using:

npm run dev

Deploy Your Commands to Discord

Finally, to deploy your commands to Discord, navigate to <BASE_URL>/deploy?secret=<DEPLOY_SECRET> in your browser. This will send your command data to Discord to register them with your bot.

Prepare a Server

Since you're deploying a Bun project, you'll need a server to host your bot. You'll also need to set up Bun and Git on your server.

Initialize a Git Repository

You'll need to transfer your project files to your server, this can be done using Git and GitHub. To do this, initialize a new Git repository, commit your files and push them to GitHub. On your server you can then clone your repository.

Prepare Environment

Almost there! Now just like in development, you'll need to set up a proxy, configure your environment variables and set up your Discord app's URLs. Additionally, you'll need to install your dependencies using:

npm install

Start the Bot

Now that you've prepared your environment, you can finally build and start your bot using:

npm run build
npm run start

You may also want to set up a process manager like PM2 to keep your bot running in the background.