Guide

Creating a GitHub Account

If you don't have a GitHub account, the first thing you need to do is create one using your mobile phone. Note that creating an account is completely free.

1. Open your browser (like Chrome or Safari) and go to github.com/signup.
2. Once it opens, you will find a form to fill out.
3. Enter your email address (make sure it is active).
4. Enter a password.
5. Enter a username. It is important to choose one you like (for example: fatima-cs or sunusi-kano).
6. Click the button at the bottom that says "Create account".
7. GitHub will send a special code (OTP) to your email.
8. Go to your email, copy this code, return to your browser, and enter it.
9. Then click the button that says "Continue".

Creating a GitHub Repository

After creating your GitHub account, the next step is to create a repository.

1. Open your browser (like Chrome or Safari) and go to github.com/new.
2. Once it opens, you will find a form to fill out.
3. Look for the box labeled "Repository name", and enter your GitHub username followed by ".github.io" in lowercase letters. For example, if your username is "aminu-kano", enter "aminu-kano.github.io".
4. You can skip all the other boxes. You do not have to fill them out.
5. Then click the button that says "Create repository".

Uploading Your Portfolio to GitHub

After creating your repository, the final step is to extract your pages from the ZIP file you downloaded, and then upload them to GitHub.

If you haven't downloaded your portfolio yet, go back and download it first.

1. Open the "File Manager" or "Downloads" folder on your phone.
2. Find the file you downloaded named "Portfolio_yourname.zip".
3. Tap the file and select "Extract" or "Uncompress". This will extract your actual pages (like index.html, about.html, and your profile.jpg picture).
4. After you finish extracting, return to your browser where you created the repository.
5. In the middle of the page, you will see a blue text that says "uploading an existing file"; click it.
6. Click "Choose your files". Your phone will prompt you to select your files.
7. Go to the folder you extracted earlier, and select ALL the files together (make sure to include your profile.jpg picture).
8. Wait until they are fully uploaded, then scroll down to the bottom and click the green button named "Commit changes".

Viewing Your Website Online

After clicking the commit changes button, the hard work is done. Your website will go live online.

1. Give it about two to three minutes for GitHub to set everything up.
2. Open a new tab in your browser and type the exact name of the repository you created earlier. That is, your username followed by ".github.io".
3. For example, if your username is "aminu-kano", type "aminu-kano.github.io" into your browser to view your live portfolio.