From fec46a25138ee52fe0a5ea967e9ea2f0ee70b664 Mon Sep 17 00:00:00 2001 From: Maddy Guthridge Date: Sat, 3 Oct 2026 22:43:49 +1000 Subject: [PATCH] docs: document discord authentication setup process (#3435) --- docs/dev/discord-auth.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 docs/dev/discord-auth.md diff --git a/docs/dev/discord-auth.md b/docs/dev/discord-auth.md new file mode 100644 index 000000000..d27e56bb3 --- /dev/null +++ b/docs/dev/discord-auth.md @@ -0,0 +1,22 @@ +# Configuring Discord Authentication + +## ⚠️ You probably don't need this ⚠️ + +When run in dev mode, Sendou provides the option to "impersonate" an account in +the developer menu. You can use this to authenticate without configuring Discord +auth. + +If you need to test or debug Discord authentication, here's how to proceed: + +## Configuring Discord authentication + +1. Log into the [Discord developer portal](https://discord.com/developers/applications). +1. Create a new application for your sendou development setup. +1. Navigate to the ***Oauth*** settings. +1. Add a ***redirect*** for `http://localhost:5173/auth/callback`. If your dev + server is running elsewhere, make sure the hostname and port match. +1. Copy the ***Client ID*** into the `.env`. +1. Reset the ***Client secret***, and copy the new value into your `.env`. Note + that it won't be shown again, so make sure to grab it. +1. If your dev server is running, it should have automatically reloaded. If not, + restart it.