A web app that can send invitations to GitHub users to join a given GitHub organization. The app uses a valid personal access token of an admin user in that GitHub organization to send invitations.
To send an invitation three things must be provided:
The way this app requires the above mentioned three items, depends on your choice of version to use. Four versions are available and they require different ways of providing the above three items.
In this version, provide an org.js
file in the root folder that exports a JSON object containing name
(organization's name) and token
properties. Host the node server. In its frontend, a GitHub user can enter their username
and get invited to your organization. They will receive proper feedback, whether they was successfully invited or not and possible reasons for that.
In this version, create a firebase project at https://console.firebase.google.com and set it up and deploy as in the Firebase Version README. Your Github-Invite is at your <project_id>
.web.app. Share this link with your invitees. It contains a frontend similar to that of the Node Monolith above, where the GitHub user can enter their username and get invited to your organization.
In this version, you enter your organization's name on GitHub, an admin's personal access token and the username of the GitHub user to be invited, directly in the static frontend of the website and JavaScript will do the invitation. Proper feedback is equally shown directly in the website whether the invitation was successful or not and possible reasons for that.
It is hosted with GitHub pages at https://obumnwabude.github.io/github-invite/ So, you can click on that link and perform as many invitations as you wish.
In this version, you install github-invite
CLI with through npm/NodeJS, and then you use the CLI to send invitations directly from the command line. You can then choose to either enter github-invite
, and then the CLI will interactively demand the org
, username
and token
, that is:
github-invite
OR
You can enter all three arguments at once with the github-invite
command as follows:
github-invite <org> <username> <token>
The github-invite
CLI also outputs feedback properly as invitations are done, and whether invitations were successful or not, and possible reasons for that.
Feel free to customize the frontends of the and
versions to suit your brand's guidelines. However, avoid tampering with the parts of the code that give feedback and make the app work.
If you have find any problems while using this software, or you come accross any bugs, or you want to add a feature, please feel free to create an issue or pull request. Thank you!