π Deploy Your Modernized Portfolio to GitHub Pages
β Pre-Deployment Status
Your portfolio is ready to deploy! All GitHub Pages issues have been fixed.
π― Quick Deploy Guide
Step 1: Test Locally (Important!)
Make sure everything works at http://localhost:4000
Test these URLs:
- http://localhost:4000/ (Homepage)
- http://localhost:4000/blog/ (Blog with categories)
- http://localhost:4000/blog/#career (Category filtering)
- http://localhost:4000/about/ (About page)
- http://localhost:4000/old-version/index.html (Old version)
- http://localhost:4000/assets/article_images/2020-02-22-Tyson-Fury-versus-Wilder/LastFightData/ (Fight stats)
Test these features:
- Theme toggle works (moon/sun icon)
- Navigation smooth scrolls
- Mobile menu works
- Category filtering works
- All links work
Step 2: Commit Your Changes
cd C:\Users\Marti\Desktop\gith\simplisticmartin.github.io
# Check what's changed
git status
# Add all files
git add .
# Commit with descriptive message
git commit -m "Complete portfolio modernization: Add blog categories, theme toggle, JPMC & GT updates, and enhanced data visualization"
# Push to GitHub
git push origin master
Step 3: Wait for GitHub Pages Build
- Build takes 2-10 minutes
- GitHub automatically builds when you push
- Check progress: Repository β Actions tab
Step 4: Visit Your Live Site!
https://simplisticmartin.github.io/
https://simplisticmartin.github.io/blog/
π Detailed Deployment Steps
Before You Deploy
1. Update Personal Information
Edit _config.yml:
title: "Martin Li"
email: simplisticmartin@gmail.com
# Verify all info is current
2. Update Resume
Replace /Resume.pdf with your latest resume showing:
- JPMorgan Chase position
- Georgia Tech OMSCS
- Latest skills and projects
3. Review Content
- Check all blog posts for typos
- Verify about page is current
- Ensure project descriptions are accurate
4. Test Everything Locally
Run through entire site at http://localhost:4000
π» Git Commands Explained
Check Status
git status
# Shows what files changed
Stage All Changes
git add .
# Adds all modified files
Stage Specific Files
git add _config.yml
git add blog.html
git add assets/css/modern.css
# Adds only specific files
Commit
git commit -m "Your descriptive message here"
Good commit messages:
β
"Add blog category system with 7 categories"
β
"Update professional profile with JPMC & Georgia Tech"
β
"Fix GitHub Pages 404 by renaming Blog.html to blog.html"
β
"Modernize fight data visualization with Chart.js"
Bad commit messages:
β "update"
β "fix"
β "changes"
Push to GitHub
git push origin master
# Sends your changes to GitHub
π Monitoring the Deployment
Method 1: GitHub Actions
- Go to: https://github.com/simplisticmartin/simplisticmartin.github.io
- Click βActionsβ tab
- See your deployment workflow
- Green checkmark = Success β
- Red X = Failed β (click for details)
Method 2: Repository Settings
- Go to repository Settings
- Click βPagesβ in left sidebar
- See deployment status
- Get live URL
Method 3: Direct Visit
Just visit: https://simplisticmartin.github.io/blog/
- If it loads β β Deployed!
- If 404 β β³ Still building (wait a few minutes)
β±οΈ Deployment Timeline
0:00 - Push to GitHub
0:01 - GitHub receives push
0:02 - Build starts automatically
0:03 - Jekyll builds your site
0:05 - Deploy to GitHub Pages
0:07 - CDN updates
0:10 - Site fully live!
Average time: 5-10 minutes
π Troubleshooting
Build Fails
Check GitHub Actions for error message:
- Go to Actions tab
- Click failed workflow
- Read error message
- Fix issue locally
- Push again
Common issues:
- Missing files β Check all files committed
- YAML syntax error β Validate
_config.yml - Liquid syntax error β Check templates
- Missing gems β Ensure Gemfile is committed
Site Not Updating
Try these:
- Hard refresh: Ctrl+Shift+R
- Clear cache: Browser settings
- Incognito mode: Test without cache
- Wait longer: CDN can take 10-15 minutes
- Check Actions: Verify build succeeded
404 Errors
If specific pages 404:
- Check filename capitalization
- Verify file is committed
- Check
_config.ymlexclude list - Ensure proper front matter
π What Will Be Deployed
Your Complete Modern Portfolio:
β Homepage
- Teal gradient hero
- Particle animation
- JPMC & Georgia Tech credentials
- Projects showcase
β Blog System
- 7 organized categories
- Category filtering
- Professional layout
- Social sharing
β Data Visualization
- Interactive Fury vs Wilder stats
- Modern Chart.js implementation
- Responsive charts
β Theme Toggle
- Light/Dark mode
- Saves preference
- Smooth transitions
β Old Version
- Complete backup
- Fully accessible
- Original design
β About Page
- Updated professional profile
- JPMC experience
- Georgia Tech OMSCS
π¨ After Deployment
Share Your Site
Update these places:
- LinkedIn profile - Add website URL
- GitHub profile README
- Resume - Include portfolio link
- Email signature
- Social media bios
Submit to Search Engines
Google Search Console:
- Add property: https://simplisticmartin.github.io
- Verify ownership
- Submit sitemap: /sitemap.xml
- Monitor indexing
Other Search Engines:
- Bing Webmaster Tools
- Submit to directories
Enable Analytics (Optional)
- Get Google Analytics 4 property ID
- Add to
_config.yml:google_analytics: "G-XXXXXXXXXX" - Redeploy
π Post-Deployment Monitoring
First Day
- β Verify all pages load
- β Test on mobile device
- β Check all links
- β Verify images load
- β Test theme toggle
- β Try category filtering
First Week
- Write your first new blog post
- Share on social media
- Get feedback from colleagues
- Monitor any issues
Ongoing
- Write blog posts regularly
- Update projects as you complete them
- Keep resume current
- Monitor analytics (if enabled)
π― Deployment Command Summary
# One-time full deployment
cd C:\Users\Marti\Desktop\gith\simplisticmartin.github.io
git add .
git commit -m "Complete portfolio modernization"
git push origin master
# Future updates (new blog posts, etc.)
git add _posts/2026-01-21-new-post.md
git commit -m "Add new blog post about AI at Georgia Tech"
git push origin master
π Need Help During Deployment?
Resources
- GitHub Pages Docs: https://docs.github.com/en/pages
- Jekyll Docs: https://jekyllrb.com/docs/github-pages/
- Your Docs: Check
GETTING_STARTED.md
Common Commands
# View git history
git log --oneline
# Undo last commit (keep changes)
git reset --soft HEAD~1
# Check remote
git remote -v
# Pull latest (if collaborating)
git pull origin master
β Final Checklist
Before pushing to GitHub:
- Tested all URLs locally
- Theme toggle works on all pages
- Blog categories filter correctly
- Old version accessible
- Fight data visualization impressive
- Personal info updated (JPMC, GT)
- Resume is current
- No console errors
- Mobile responsive verified
- All documentation files included
π Ready to Deploy!
Your portfolio is:
- β Fully modernized
- β GitHub Pages compatible
- β Professional & impressive
- β SEO optimized
- β Mobile responsive
- β Error-free
- β Well-documented
Run the deployment commands above and your site will be live in minutes!
π After Itβs Live
Your portfolio will showcase:
- πΌ Software Engineer @ JPMorgan Chase
- π MS in CS (AI) @ Georgia Tech OMSCS
- π€ AI & Machine Learning expertise
- π Data visualization skills
- π» Full-stack development capabilities
- βοΈ Professional blog with organized categories
- π¨ Modern, clean design
Visitors will see a professional, enterprise-grade portfolio that highlights your impressive credentials and technical skills!
π Deploy now and share your amazing portfolio with the world!
git add .
git commit -m "Launch modernized portfolio"
git push origin master