Your first edit

Make sure that you've gotten your Github account ready. If not, please refer to Create a Github Account.

First, head down to Isomer's Github Organisation ( You can look for your site using the search bar. If you encounter any problems, you may contact the team.

A repository is like a Google Drive folder where your site's content and data are stored.

In this guide, we'll use the FAQ page for you to make your first edit. Make sure you're in the staging branch. We've set staging as your default branch so there is no need to change it.

Open the pages folder, and click on Once in, click the edit button (an icon that looks like a pencil).

The content of Isomer sites are written in Markdown. You can ignore the stuff at the top of the page, between the pair of triple dashes (---). Type something after the second set of triple dashes. The file should now look something like this:

title: FAQ
permalink: /faq/
Hello, Isomer! This is my very first edit!

Scroll to the bottom of the page, and add a simple note of the changes you've made under 'Update'. You can also add more details in the subsequent large text box.

Make sure the option 'Commit directly to the staging branch.' is selected, and click 'Commit changes'.

Wait for about a few minutes, then head to your site's staging site (which is provided by the isomer team, it typically has this format On the staging site, head to the FAQ page.

Congratulations! You have just made your very first edit to an Isomer site!

Additional information

The moment a commit is made on GitHub, GitHub sends the updated content of your site to Netlify that we use to build Isomer sites. Netlify then downloads the central Isomer theme, weaves your content into the theme, building a complete site. This build process usually take less than a minute for most Isomer sites, but larger Isomer sites can take up to 10 minutes.

Last updated