Set up a GitHub account

This page is only for users who log into IsomerCMS with their GitHub ID. If you log in with your .gov.sg or other whitelisted email, you do not need to go through this process. As of Q3 2023, all new IsomerCMS users should log in with their email.

---

If you’re being added to a website that uses GitHub ID login, you must set up a GitHub account in order to be added as a collaborator to edit the website on IsomerCMS.

The images in this guide may be outdated but the overall steps remains the same.

1. Create a GitHub account

Use your preferred email address and a set a professional username. Follow the steps to retrieve the code sent to the email you used. You can set any preferences based on what makes sense to you, these do not impact your Isomer experience.

Click ‘Continue for free’ for a basic plan

You will only need a basic account on GitHub to edit the content of your Isomer website.

2. Turn on 2-Factor Authentification

Enabling two-factor authentication (2FA) on your account can block up to 99% of automated attacks. To ensure the security of our users, Isomer requires all users to enable 2FA on their accounts.

Follow the steps listed here to enable your 2FA . Note that you can pick any method of authentification out of TOTP, SMS, or security key.

CAN WE RECCO SMS?

GitHub will prompt you to save your recovery codes. The purpose of these codes are to guarantee you are the owner of your account in case your 2FA fails, such as when you lose your phone.

We strongly encourage saving these codes somewhere secure.

3. Request for access to Isomer’s GitHub

After setting up your 2FA, you will need access to your site to start editing it on IsomerCMS.

• Fill in this form to request for access to an Isomer site. You will receive an invite to your registered email once we’ve added you to the repository.

• Click on the link in your email and accept the invitation by clicking on Join Isomer.

You should see a banner notifying you that You are now a member of Isomer!

Take note of your GitHub user types

All users on Isomer holds the same GitHub access type – editor access. With editor access, you’ll be able to make changes to your site, create a pull request, and approve someone else’s pull request.

We do not provide pages specific restricted access but do note that all changes are tracked (even a single full stop you add to or remove from the page). That being said, do make changes to your site responsibly as all these changes are being tracked.

All isomer team members are admin users (with the ability to create new site, add and remove users, and grant permissions to users)

View the list of users in your team

1. Go to github.com/isomerpages
2. Click on the team’s tab
   < INSERT >
3. Enter your repository name in the search field