Discord apps are a great way to keep your community fun and engaging. You can create minigames for your server, tools to generate inspiration, or even provide educational resources.
Recently, Discord announced support for Premium App Subscriptions, a new feature that will allow developers the option to monetize their Discord apps natively on the platform, instead of through third party processors and websites. So what better time to start building Discord apps?
In this tutorial, we’ll walk you through the process of building and hosting a Discord app using Gadget’s hosted and scaled Node backend, Postgres database, and auto-generated CRUD API for custom data models. By the end, you'll have a production-ready variation of a Rock, Paper, Scissors game that integrates seamlessly into your Discord server.
If you prefer a visual aid, you can also follow along with our video tutorial.
Let's dive in!
Step 1: Creating Your Discord App
Throughout this tutorial, we’ll be referencing Discord’s “Getting Started” app guide. To help you get an understanding of the different ways Discord apps can be used, this app will explore the use of slash commands, send messages, and respond to component interactions.
Start by creating a new app in Discord. Once you give your app a name, you’ll be directed to your developer dashboard.
On the left menu, navigate to OAuth2 > URL Generator and select the necessary scopes and permissions. For this build, we’ll be using the bot scope, and the send messages permission. Copy the generated URL, open it in a new tab, and follow the steps to authorize your app and install it on your server.
Step 2: Running Your App with Gadget
Usually, Discord recommends using Glitch to host an app and get it up and running quickly. But due to its technical limitations, Glitch is typically not suited to production-grade apps. Gadget, on the other hand, auto-scales with your app, so you’re able to transition from prototype to production app without starting a new project.
If you haven’t used Gadget before, don’t worry — you can spin up a project with development and production environments for free.
Gadget has a forkable Discord app template ready, so head over to https://discord-getting-started.gadget.app/ and fork the project. All the code you need to run the project is already set up. This template includes a Node.js backend, CRUD API, and Postgres database, with the games model set up and ready to build.
Note: If you want to build something more complex than the initial starter app, you can create and add new models as needed.
You will, however, need to set up some environment variables. In the Gadget project Settings, go to Environment Variables and paste the App ID and Public key from the General Information page of your Discord app into the PUBLIC_KEY and APP_ID variables for your Development environment.
You’ll also need a Discord token. To do this, from your app in the Discord developer dashboard, navigate to the Bot tab and reset your bot’s token. Discord will automatically generate a new token for you. Copy and paste that into your app’s DISCORD_TOKEN environment variable, and click the lock icon to encrypt it.
Step 3: Handling Interactivity
The Discord getting started app template we forked in Gadget comes with an HTTP route preconfigured. If you need to customize it at all, you can find it in the routes/POST-interactions.js file. This is what we will use to handle all of the incoming activity from Discord.
To set your interactions endpoint URL, input <your-gadget-url>/interactions into the Interactions Endpoint URL field on the General Information page of your Discord developer dashboard. Make sure you use the URL for your development environment! To get this URL, you can go to your Gadget app’s Home page and click the copy button next to the provided URL.
Step 4: Adding Message Components
The final step involves populating the message components and adding them to your Discord server. To do this, you’re going to need to set up a Global Action in your Gadget app. You’ll be using the registerCommands action to install both the test and challenge commands onto your discord server.
If you click Run Action, you can test the Global Action in the API playground before confirming that the /test and /challenge commands are working correctly on your Discord server.
Congratulations! You now have a fully functional Discord bot built on Gadget's production-grade infrastructure.
Why did we use Gadget instead of Glitch?
One significant advantage of Gadget is the Postgres database included with every project. If you wanted to see the game you just played to test your app, you can find the specific record for it in your database. The game data model we used includes user ID, message ID, and the chosen object (rock, paper, or scissors).
Gadget also provides automatic CRUD actions for data models. In the case of the Rock, Paper, Scissors app, you can use these to store game records in the database.
If you want to deploy your app to production, all it takes is a click with Gadget. Simply copy over the environment variables from your development environment to the production version.
And just like that, you have a production-ready Discord app.
If you have questions or want to connect with other developers, check out Gadget's documentation or join our Discord server. Happy coding!
Top comments (1)
Cool tutorial!