Principles and Practices

Git configuration (once per machine)

git config --global user.name "your username"
git config --global user.email "your_email@gmail.com"

Download Node.js if needed, open the project folder in Cursor, and run terminal commands from that directory.

GitHub remote setup & Pages — full walkthrough (example: Printer)

This section records the full sequence: create a GitHub repository, bind local files, fix HTTPS token errors, resolve “rejected / fetch first”, and publish on GitHub Pages. Example repo: LeLi1107/Printer — replace with your username and repo name.

Phase 1 — Create repository and bind locally

1. On GitHub: New repository → name (e.g. Printer) → Public → Create. (If you add a README on creation, see Phase 3 — remote will have an extra commit.)
2. In Cursor’s terminal, cd into the folder that contains your site (e.g. index.html).
3. Initialize Git, stage files, and commit before the first push:

git init
git add .
git commit -m "Initial commit of printer control UI"

Add the remote (HTTPS URL from the repo page):

git remote add origin https://github.com/LeLi1107/Printer.git

If Git still uses master, rename the branch to main:

git branch -M main

Phase 2 — Token authentication

Error seen: remote: Invalid username or token. Password authentication is not supported.

Cause: GitHub disabled password pushes over HTTPS; use a Personal Access Token (classic) with repo scope.

Token: GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate. Copy the ghp_… string once.

“Direct” HTTPS URL (embed username + token; use only on a trusted machine, never commit or screenshot the real token):

git remote set-url origin https://LeLi1107:YOUR_TOKEN_HERE@github.com/LeLi1107/Printer.git

Phase 3 — Push rejected (fetch first)

Error seen: ! [rejected] main -> main (fetch first) — remote has commits (e.g. README) that you do not have locally.

Option A — Merge histories: git pull origin main --allow-unrelated-histories, fix conflicts, then git push -u origin main.

Option B — Overwrite remote with local (only if nothing on GitHub must be kept):

git push -u origin main --force

Phase 4 — GitHub Pages

1. Repo → Settings → Pages.
2. Build and deployment: Branch = main, folder = / (root) (or /docs if the site is under docs/).
3. Actions tab: wait until pages build and deployment succeeds (green check).
4. Project Pages URL shape: https://leli1107.github.io/Printer/

Note: Pages serves over HTTPS, which satisfies Web Serial’s requirement for secure context (along with localhost).

Stage 4

I used cursor's AI with the following prompt:

I now want to create a FabAcademy 2026 personal website, 
style reference apple.com, needs to include Home, Weeklywork, 
Finalproject, Aboutme, where Weeklywork has 20 assignments inside, 
and needs two modes, dark mode and light mode, help me generate it.

Subsequently used gemini for code troubleshooting, and continued to use cursor for optimization.

After completion, perform version upload

Steps	Command
1. Record changes	git add .
2. Write commit message	git commit -m "update description"
3. Send to cloud	git push origin main