Northbound/DISCORD_HOOK_GUIDE.md

Git Discord Notification Hook

Send commit notifications to Discord with Korean text support.

Requirements

• Node.js (required for Korean text support)
  • Download from: https://nodejs.org/
  • Install the LTS version

Installation

1. Open your project folder

2. Run the setup script:

   .\setup-hooks.ps1
   

3. Configure your Discord webhook URL:

   • Open git-hooks/send-discord.js in a text editor (Notepad, VS Code, etc.)
   • Find line with webhookUrl =
   • Replace the URL with your Discord webhook URL
   • Save the file
   • Run .\setup-hooks.ps1 again to apply changes

That's it! Now every commit will send a notification to Discord.

How to Get Discord Webhook URL

1. Open your Discord server settings
2. Go to Integrations → Webhooks
3. Click New Webhook
4. Copy the Webhook URL
5. Paste it into git-hooks/send-discord.js

What Gets Sent to Discord

• Commit hash
• Author name
• Commit message (supports Korean/other languages)
• List of changed files

Troubleshooting

Hook not running?

• Make sure you ran .\setup-hooks.ps1 after cloning the repo
• Check that .git/hooks/post-commit file exists

Korean text showing as ????

• Make sure Node.js is installed
• Run node --version in terminal to check

Hook sending errors?

• Verify your Discord webhook URL is correct
• Check that the webhook has permission to send messages

Uninstalling

Run this to remove the hooks:

rm .git/hooks/post-commit .git/hooks/send-discord.js