personal-software

GitHub OAuth

The desktop app uses a loopback HTTP OAuth callback for Sign in with GitHub. Create a GitHub OAuth app with a callback URL like:

http://127.0.0.1:46219/github/callback

GitHub requires the callback port to match the registered callback URL. Start the app with:

GITHUB_OAUTH_CLIENT_ID=your_client_id \
GITHUB_OAUTH_CLIENT_SECRET=your_client_secret \
GITHUB_OAUTH_CALLBACK_PORT=46219 \
npm run electron:dev

The secret is read from the local environment only and the resulting access token is stored through Electron safe storage.

Verify the local HTTP callback behavior with:

npm run test:oauth