Flaws in "Build your First Discord App" tutorial

[mak22223]

Description

Just passed that tutorial and found several missing instructions:

• there is no mention that at step 3 you have to add InteractionResponseFlags, MessageComponentTypes to list of the entities being imported from discord-interactions and ButtonStyleTypes at step 4.
• no mention that you have to extract id from request body. You have to add id to the following list const { type, id, data } = req.body;
• no mention to add const activeGames = {}; to declare games storage variable. (step 4)
• lack of return statement after successful InteractionType.MESSAGE_COMPONENT request processing. If you follow the tutorial every such request will additionally result into error 400 response.

Still there is an example directory with correct code that you can refer to. Though in the guide there is no metion of it and it's kinda confusing for a begineer that you follow the guide, that explains every step, but you have to look at the example and search for differences.

Steps to Reproduce

Follow the guide from the scratch

Expected Behavior

The guide should contain all necessary steps and explanations to write an app following it

Current Behavior

Following the guide isn't enough for application to run correctly

Screenshots/Videos

No response

Client and System Information

Windows 10, node.js 22.11.0

[reverentgeek]

Hi, I just completed the tutorial and also ran into some issues. I didn't see all the ones mentioned in the original issue description. Still, I wanted to confirm that without any return in the if ( type === InteractionType.MESSAGE_COMPONENT ) { block, the code falls through to unknown interaction type, and the command fails.

Also, ngrok has changed how you download their app, so the link in the tutorial goes to a 404. The new download URL is https://download.ngrok.com/. Even their 404 page has the outdated URL 😬

[colinloretz]

@reverentgeek thanks for the report, I have a PR to add the return to the tutorial. it fixed in the example code but it didn't sync with the tutorial. Apologies for the extra hurdle. The other items were also fixed so I'll close this out once its merged.

The ngrok download URL is working for me but I'll take another look at that

[reverentgeek]

Awesome!