Back to Weekly Assignments

Week 1: Project Management

Missions of the Week1 Assignments

  • Sign and uplodaded Student Agrement
  • Work through a Git Tutorial
  • Create a basic HTML page for my assignment
  • Upload the page to your GitLab repository
  • Submit the URL of your page to the assignment link
  • As a page with sketches and decritions of my final project

Student Agreement:

I agree to abide by the rules of the Fab Academy and to conduct my work in a professional manner. I understand that I am responsible for my own learning and that I will be evaluated based on my participation and performance in the class.

View the Student Agreement · Markdown source

Research and Sketches

This week I worked on defining my final project idea and started to getting used to the documentation process.

Over the weekend, I accompanied my daughter as she played with Bead Art at the mall. She accidentally mixed all the colors together, making them extremely difficult to separate. Afterward, I researched online and found that many people enjoy Perler Bead Art, yet there currently isn't a small mechanical device available to sort the colors. So, I decided to try making a Perler Bead color sorter to help more players efficiently and quickly sort their beads.

Description of image Description of image

Git Repository Setup & Version Control

What’s Git?

Git is a version control software that allows developers to develop the same project. It allows developers to track the changes to a set of files which is called “repository” or “repo”.It allows you to go back to previous versions, and helps multiple work on the same project without problems. - Example: Edit file name -> save & commit -> Git remembers exactly what changed

For the project management, Fab Academy use GitLab as a student repository to store documentation files.

Firstly, I need to login to gitlab.fabcloud.org and choose sign in with “Fablabs”.

GitLab login
  • NOTE:The email address must be the same as your Fab Academy account.You can login with “Fablabs”dirictily.

    Learn more about GitLab Pages

    Initial set up and workflow decisions

    At First, I started by testing the GitLab Web IDE directly in the browser, and through it I understand how the repository works and how changes affect the live website before setting up a full local workflow. Then moving from WEB IDE to Local Development.

    GitLab web IDE GitLab web interface

    Step 1: Create a New Repository

    Goto gitlab.fabcloud.org and sign in, navigate to the "Projects" section and click the "New Project" button. Give a name and description of my project(Maggie Zhang), and select the "Public" visibility option. Click "Create Project" to complete the setup.

    Copy the repository HTTPS URL shown on the project page and use it to clone the repository to the local machine.

    Step 2: Generate a personal access token(PAT)

    In GitLab, click the avatar in the top right corner, click on "Settings", click on "Access Tokens". Click on "Create Personal Access Token". Give a name and description of the token, and select the "API" scope. Click "Create Token" to complete the setup. Rember to set an expiry date for the token.

    Description of image

    Description of image

    Step 3: Clone the Repository

    In your terminal, run the following command to clone your repository: 

                            git clone https://gitlab.fabcloud.org/<your-group>/<your-project>.git
                        cd <your-project>

    When prompted for a username enter your GitLab username; for the password paste your PAT (not your GitLab password).

    Step 4: Push Changes

    Push your changes to the remote repository using the following command: git push origin main

    • Useful links