BLUPI

GIT DEPLOYMENT & LEARNING

Standard Deploy

Step 1: Save Staging

git add . && git commit -m "update" && git push origin main

Step 2: Push to Production Branch

git checkout production &&
git pull origin production &&
git merge main &&
git push origin production &&
git checkout main

✓

Health Check

If screen is blank but console is "running":

1. Hard Refresh (Browser)

Browser cache often hides new styles. Use Cmd + Shift + R.

2. Restart Command

Forces the server to stop and restart completely.

kill -9 -1

Standard Pull

Run in Production Replit

git pull origin production

Standard Update Procedure

Emergency Fix

Force Mirror (Ghost Typo Fix)

Run in Staging to force Prod to match Main exactly.

git checkout production &&
git reset --hard main &&
git push origin production --force &&
git checkout main

Force Pull

Run in Production to overwrite everything with GitHub's version.

git fetch origin &&
git reset --hard origin/production

Only if Standard Pull fails

The Git Dictionary

Git is your project's time machine. Use it to experiment without the fear of breaking your app permanently.

The Daily Routine

git status

The "Where am I?". Run this anytime you feel lost. It tells you which branch you're on and which files you've changed but haven't saved yet.

git add .

The "Staging Area". This tells Git: "I want to save these specific changes." The dot . means everything.

git commit -m "message"

The "Snapshot". This officially saves your changes with a note. Make your messages useful (e.g., "fixed dark mode dots") so you can find them later.

Moving Data

Local vs. Remote

Your Computer vs. The Cloud. Changes you commit stay on your local Replit (Local) until you push them to GitHub (Remote).

git push / git pull

The Syncer. push sends your work up to GitHub; pull brings new work down.

Branch Management

git checkout -b [name]

Branching Off. Creates a new branch. Essential for trying out a new feature without touching the working code in main.

git merge [branch]

Bringing it Home. Combines changes from another branch into your current one. This is how you "graduate" code from feature to main.

Solo Dev Survival Kit

git stash

The "Pause" Button. If you're halfway through a change but need to switch branches quickly, stash hides your changes. Use git stash pop to bring them back later.

git commit --amend

The "Typo Fix". Just committed but realized you forgot a semicolon? Fix the code, add it, and run this to add it to your previous commit instead of making a new one.

git diff

The "Spot the Difference". Shows you exactly what lines you've changed since your last commit. Great for double-checking your work before pushing.

The "Uh-Oh" Tools

Merge Conflict

The "Argument". Happens when Git sees two different changes to the exact same line of code. You have to manually delete the <<<< markers to fix it.

git reset --hard HEAD

The Ultimate Undo. Deletes every unsaved change and sets your project back to the last successful commit. Use with care!

Project Housekeeping

.gitignore

The Secret Keeper. A file that tells Git which files to ignore. Never upload .env files or node_modules to GitHub!

git log --oneline

The History. Shows a quick list of your past commits. It's the best way to see the "story" of your app's growth.