Build Your First Discord Activity
Follow the guide to build your first Activity using the Embedded App SDK.
Development Patterns
Explore common development patterns and practices to make building Activities simpler.
How Activities Work
Learn more about the lifecycle of Activities and how they run in Discord clients.
Developing Activities
Whether you’re developing a multiplayer game, a new social experience, or another creative idea, your Activity will be built as a web app that is run in an iframe in Discord on desktop, mobile, and web. You can get started by following the guide on Building an Activity using the Embedded App SDK or exploring the sample projects The sections below provide an overview of the Embedded App SDK, but technical details about how Activities are run in Discord is covered in How Activities Work.Embedded App SDK
The Embedded App SDK handles all of the communication between Discord and your app, making it easier to do common tasks like managing connected users, supporting mobile clients, and debugging your Activity. The Embedded App SDK offers different events and commands to handle the communication between Discord and your Activity, which are covered more below.Commands
The SDK has a set of commands you can call to interact with a Discord client, given you have the appropriate scopes. This is helpful when you want to do authorize and authenticate users, fetch information about your Activity, or update information for your Activity or an authenticated user. Read the Embedded App SDK documentation for a full list of commands, and details about each command.Events
The SDK also has events you can subscribe (or unsubscribe) to for things happening in a connected client that are relevant to your Activity, given you have the appropriate scopes. This is helpful when you want to do things like handle initial connection and thrown errors, listen to updates about a connected user, and listen to events related to your Activity instance. Read the Embedded App SDK documentation for a full list of events, and details for each event.Sample Projects
Use the sample projects we’ve built to help you get started building quickly and learn from common development patterns. You can also find a list of community-maintained samples on GitHub, which includes more framework-specific examples.Discord Activity Starter
This TypeScript starter template is perfect for getting your own Activity up and running quickly.
Embedded App SDK Playground
This reference example implements the commands and events available to you within the Embedded App SDK.
Nested Framework App
This reference example demonstrates an Activity using a nested framework like a game engine.