---
title: Ex1: Create your GitHub Project
slug: saga-hol/ex1-create-your-github-project
createdAt: 2026-07-28T14:56:09.592Z
---

*In this section, you will create the code repository that stores your Edge Delivery Services project and connect it to your AEM authoring environment.*

:::hint{type="info"}
In Edge Delivery Services projects, your website code lives in **GitHub**, not inside AEM. This repository contains the CSS, JavaScript, and project configuration used to render your site.
:::



## Step 1 — Create a new repository from the template

1. Navigate to the Saga demo site repository template provided for this lab: [https://github.com/Skiper76/saga-xwalk](https://github.com/Skiper76/saga-xwalk)
2. Sign in using your GitHub account.
3. Click **Use this template**.

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/4LmdNQzASkwP8XOePi9cp_image.png" size="100" isUploading="false" width="2948" height="706" darkWidth="2948" darkHeight="706" showCaption="true" indent="1"}

4. Select **Create a new repository**.

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/O7hGu35A_v4FxaytfhaJB_image.png" size="50" isUploading="false" width="628" height="298" darkWidth="628" darkHeight="298" showCaption="false" indent="1"}

:::hint{type="info"}
**Note:&#x20;**&#x59;ou must be signed in to GitHub to see "*Use this template"* option.
:::



## Step 2 — Configure the new repository

1. Choose the GitHub owner:&#x20;
   - your personal account, or
   - the GitHub organization used for the lab
2. **Enter the repository name:&#x20;**

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/F4c_iovhU50vbR9vKMo79_image.png" size="100" isUploading="false" width="1568" height="1430" darkWidth="1568" darkHeight="1430" showCaption="false" indent="1"}

3. Optionally add a description.
4. Click **Create repository**.

:::hint{type="info"}
This creates your own copy of the template so you can safely develop custom code without changing the original starter repository.
:::



## Step 3 — Configure the fstab.yaml file

:::hint{type="info"}
The fstab.yaml file connects your GitHub repository to the AEM authoring environment. It tells Edge Delivery Services which AEM endpoint should be used as the content source for your project.
:::

1. In your GitHub repository, click the `fstab.yaml `file to open it:

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/l9vB3q2BQb3ccfif1Zgl2_image.png" size="100" isUploading="false" width="836" height="232" darkWidth="836" darkHeight="232" showCaption="false" indent="1"}

2. Click the **Edit this file** icon:&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/RewDZGymXp8FFlDFLHwWo_image.png" size="100" isUploading="false" width="2960" height="974" darkWidth="2960" darkHeight="974" showCaption="false" indent="1"}

3. Replace the existing code with the following config:&#x20;
   1. **Replace "Skiper76" → `<Your-GitHub-Name>`**
   2. **Replace "saga-xwalk" →&#x20;**

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/YsRcVHkElDIxsoqo0HK7X_image.png" size="100" isUploading="false" width="2324" height="573" darkWidth="2324" darkHeight="573" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
*The mount point is set up like this:&#x20;*
:::

:::CodeblockTabs{indent="2"}
yaml

```yaml
mountpoints:
  /:
    url: https://<AEM_SERVER_URL>/bin/franklin.delivery/<YOUR_GITHUB_OWNER>/<YOUR_REPOSITORY_NAME>/main
    type: markup
    suffix: .html
```
:::

4. Do the edit, and click **Commit Changes:**

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/aqbsHwJh4sJVXknNYBBlM_image.png" size="60" isUploading="false" width="1206" height="444" darkWidth="1206" darkHeight="444" showCaption="false" indent="1"}

5. Enter a commit message, select *Commit directly to the main branch***,&#x20;**&#x61;nd commit:

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/kX6VUFWU9cLCvjEEUsTF3_image.png" size="50" isUploading="false" width="1172" height="1260" darkWidth="1172" darkHeight="1260" showCaption="false" indent="1"}

:::hint{type="warning" indent="1"}
Make sure the GitHub owner and repository name match the repository you created. If the repository belongs to a GitHub organization, use the organization name instead of your personal username.
:::

6. The fstab.yaml file is now configured to use your AEM environment as the content source.



## Step 4 — Install or configure AEM Code Sync

1. In a new browser tab, go to: [https://github.com/apps/aem-code-sync](https://github.com/apps/aem-code-sync)
2. Click **Configure**.

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/aSUr3i68q14WWFVBhRixm_image.png" size="70" isUploading="false" width="2042" height="864" darkWidth="2042" darkHeight="864" showCaption="false" indent="1"}

3. Choose the GitHub account or organization where you created your new repository.

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/S8GzVY1RqM1feOzz-eSph_image.png" size="80" isUploading="false" width="1664" height="850" darkWidth="1664" darkHeight="850" showCaption="false" indent="1"}

4. Under **Repository access**, select **Only select repositories**

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/77L3Y1KgmAtGxj5AatLWP_image.png" size="100" isUploading="false" width="1393" height="1002" darkWidth="1393" darkHeight="1002" showCaption="false" indent="1"}

5. Choose the repository you created in the previous step.

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/_p29Ym1dA1OdIO8ZScYIc_image.png" size="80" isUploading="false" width="600" height="211" darkWidth="600" darkHeight="211" showCaption="false" indent="1"}

6. Click **Save**.

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/3OUYe5DHWj5JeAUfa9T-P_image.png" size="100" isUploading="false" width="1018" height="405" darkWidth="1018" darkHeight="405" showCaption="false" indent="1"}

:::hint{type="info"}
**Why This Is Needed**
AEM Code Sync connects your GitHub repository to the Edge Delivery Services delivery pipeline so that the code in your repository can be used by your site.
:::



## Step 5 — AEM Configuration Setup

We now need to connect our project with AEM, with previous step, clicking on save will take us to this **AEM Configuration Setup&#x20;**&#x70;age:&#x20;

1. Confirm you are now on this page, and click on **next**:

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/1WjIqiSQVUdHnWmABNg7-_image.png" size="100" isUploading="false" width="1089" height="451" darkWidth="1089" darkHeight="451" showCaption="false" indent="1"}

2. In **Content Source,&#x20;**&#x69;t is **already preselected&#x20;**&#x74;o "Other" and has the content source URL configured from our fstab. **Click Next.&#x20;**

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/TuEhXEPQwyG7kajVirDwT_image.png" size="100" isUploading="false" width="1068" height="648" darkWidth="1068" darkHeight="648" showCaption="false" indent="1"}

3. Add **Users**, especially **yourself as admin (add your github email AND your provided HOL email):**

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/uvVqEHCC7uP7F-MRO6rIx_image.png" size="100" isUploading="false" width="1123" height="715" darkWidth="1123" darkHeight="715" showCaption="false" indent="1"}

4. In summary, you can clic&#x6B;**&#x20;Save.&#x20;**

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/BpT41tzZkllO0cYWw2i4__image.png" size="100" isUploading="false" width="1435" height="893" darkWidth="1435" darkHeight="893" showCaption="false" indent="1"}

5. You will have a confirmation screen that your Site is ready, with all its info. **Copy the preview page link:**

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/fcj_GPMDOPZP9E_rmteFv_image.png" size="100" isUploading="false" width="1080" height="820" darkWidth="1080" darkHeight="820" showCaption="false" indent="1"}



## Congratulations!

You now have:

- A GitHub repository containing your Edge Delivery Services project code.
- AEM Code Sync configured for the repository.
- An fstab.yaml file connecting the repository to your AEM environment.
- An AEM site configuration with the appropriate users and content source.

Your project is ready for the next step: creating a new AEM site, using our EDS configuration.&#x20;
