> ## Documentation Index
> Fetch the complete documentation index at: https://discord-dependabot-npm-and-yarn-actions-core-3-0-1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Principles

> Core design principles for creating effective Discord Social SDK integrations.

<Info>
  Any in-game imagery used in is purely fictional for concept purposes.
</Info>

## 1. Add Value for the Player

This integration aims to bring value to the player's gaming experience. Branded connection points should highlight said value-add based on the context.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/Principle-03.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=8574a66d42a7214a4d6537d91d4ae688" alt="Add Value for the Player" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/Principle-03.png" />

## 2. Foster trust with Discord's brand

Lean into Discord's visual-styling to establish trust through brand recognition. The more players that connect, the more robust the social graph is for the game.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/Principle-04.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=45c75b0ad869f7f10a193755b25b119c" alt="Foster trust with Discord's brand" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/Principle-04.png" />

## 3. Promote Understanding through consistency

Use consistent branding and user-flows across games to build expected behavior. We care about the UX, not the UI.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/Principle-05.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=6223d1a899f46b018f9d1704cf5603b3" alt="Promote Understanding through consistency" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/Principle-05.png" />

## 4. Prioritize the player's immersion

Our focus is on preserving the player's immersion in the game. There are no requirements to replicate Discord's UI. The visual-design should feel as seamlessly integrated into the game as our SDKs.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/Principle-06.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=9a1b5cdf51fe21b2ff25882707cb811e" alt="Prioritize the player's immersion" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/Principle-06.png" />

## 5. Uphold data privacy, transparency, and control

Each platform is in control and responsible for the data on their respective platforms. Players are informed of where their data shows up.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/Principle-07.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=99f27b7850cbb854e833220877f12be3" alt="Uphold data privacy, transparency, and control" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/Principle-07.png" />

***

## Change Log

| Date           | Changes         |
| -------------- | --------------- |
| March 17, 2025 | initial release |
