Opscribe

Opscribe is a React landing page for a local-first RPA product and a public host for the GitHub OAuth browser login flow used by the site.

Available scripts

• npm start runs the app locally
• npm test -- --watchAll=false runs the test suite once
• npm run build creates the production bundle
• npm run deploy publishes the build to GitHub Pages

GitHub OAuth browser redirect setup

This site starts GitHub's browser authorization flow and captures the returned callback parameters on /auth/callback/. The frontend does not exchange the returned code for a token.

1. Create a GitHub OAuth app.
2. Use your deployed site origin as the Homepage URL.
3. Use your deployed /auth/callback/ route as the Authorization callback URL.
4. Configure the frontend with:
   • REACT_APP_GITHUB_CLIENT_ID
   • optionally REACT_APP_GITHUB_SCOPE
   • production deploys can provide the client ID through .env.production

What the callback page does

When GitHub redirects back, the callback page:

1. reads code, state, and any error query params,
2. validates the returned state against the browser session that started login,
3. stores the callback result locally so the landing page can display it.

This is enough to verify that browser redirect auth is wired correctly, but it does not complete secure token exchange or establish a real authenticated session.

Custom domain

public/CNAME is set to www.opscribe.pro so GitHub Pages can serve the app from the planned custom domain.

package.json also points homepage at https://www.opscribe.pro so the production build resolves callback and asset paths against the same root domain.