# Cloning Templates #

## Prerequisites #

It is assumed, that you have

- a registered GitHub account.
- successfully installed Visual Studio Code.
- basic knowledge, how to use Visual Studio Code.
- successfully installed μJam extension to VSCode.
- basic knowledge, how to use μJam.

## Cloning a Template #

Say you want to create a website similar to an already existing website from one of the basic μJam template repositories or others. Than you can

- clone that repository, i.e. create a local copy of a GitHub repository on your computer.
- modify structure, style and content of your local repository.
- publish your local repository to a remote repository under your GitHub account.

Let's go briefly through these steps by cloning the repository microjam-simple as an example.

> 1. Start VSCode in empty mode – with no file or folder open.
> 2. Open the Explorer View. Here you are offered to `Clone Repository`.

Fig. 1: Clone Remote Repository.

> 3. Press button `Clone Repository` and enter the template url.

Fig. 2: Enter Template Url.

> 4. You will be asked to select the local directory, where to copy the template files into.
> 5. After successfully copied the template files you recieve a notification asking you to open the cloned repository.

Fig. 3: Copy Success Notification.

> 5. You might want to open the cloned repository.

Fig. 4: Opened Cloned Repository.

> 6. Modifying structure, style and content of your local repository is described here.
> 7. For publishing your repository to your GitHub account read here or here in more detail.

If you otherwise want to go the direct way to create a remote GitHub repository from an existing template repository you are guided through this process here very well.