A clean, minimal, and professional academic portfolio template inspired by Jon Barron's website. Built with vanilla HTML/CSS/JavaScript - no frameworks needed!
Check out the live demo: xuming.ai
- Click the "Use this template" button above
- Name your repo
[username].github.iofor automatic hosting - Clone and customize with your content
- Push changes - your site will be live at
https://[username].github.io
# Clone the repository
git clone https://github.com/Mac-Huang/xuming.ai.git my-portfolio
cd my-portfolio
# Test locally
python -m http.server 8000
# Visit http://localhost:8000
# Deploy to GitHub Pages
git remote set-url origin https://github.com/[your-username]/[your-username].github.io.git
git push origin mainβ Zero Dependencies - Pure HTML/CSS/JS, no build process needed β Responsive Design - Looks great on all devices β Fast Loading - Minimal and optimized β SEO Friendly - Semantic HTML with proper meta tags β Multiple Sections - Research, Projects, Blog, Teaching, and more β Interactive Demos - Showcase your work with live examples β Dark Mode Support - Easy to add with CSS variables β Customizable - Simple structure, easy to modify
π¦ your-portfolio/
βββ π index.html # Home page with bio and highlights
βββ π research.html # Publications and research projects
βββ π projects.html # Project showcase with filtering
βββ π blog.html # Blog posts listing
βββ π courses.html # Teaching and courses
βββ π bot.html # AI assistant (optional)
βββ π¨ stylesheet.css # Main styles (customize colors here!)
βββ π data/
β βββ projects.js # Project data (easy to update)
β βββ publications.js # Publication data
βββ π demos/ # Interactive project demos
βββ π blog/posts/ # Blog post HTML files
βββ π js/ # JavaScript functionality
βββ π images/ # Images and assets
βββ π cv/ # Resume/CV files
Edit index.html:
<!-- Update your name -->
<name>Your Name</name>
<!-- Update your bio -->
<p>Your research interests and current work...</p>
<!-- Update contact links -->
<a href="your-cv.pdf">CV</a>
<a href="https://github.com/your-username">GitHub</a>Replace images/profile.jpg with your photo (square aspect ratio recommended)
Edit data/projects.js:
const projects = [
{
id: 'project-id',
title: 'Your Project Title',
description: 'Project description',
tech: 'Python, PyTorch, etc.',
thumbnail: 'images/projects/your-thumb.jpg',
demo_url: 'demos/your-demo.html',
code_url: 'https://github.com/your-repo',
featured: true
},
// Add more projects...
];Edit data/publications.js to add your papers
Edit stylesheet.css:
:root {
--primary-color: #1772d0; /* Change main color */
--text-color: #333;
--bg-color: #ffffff;
}Create new HTML files in blog/posts/ and link them in blog.html
- Create demo HTML in
demos/folder - Include D3.js, Three.js, or any library via CDN
- Link from projects.js
The template includes JavaScript-based email protection in js/main.js
- Update meta tags in each HTML file
- Add structured data for better search results
- Customize Open Graph tags for social sharing
- Push to repo named
[username].github.io - Enable Pages in Settings β Pages
- Select main branch and root folder
- Connect your GitHub repo
- Auto-deploys on push
- Custom domain support
npm i -g vercel
vercel --prod- Papers First: Lead with your publications on the homepage
- Visual Projects: Include screenshots/GIFs in project cards
- Blog Regularly: Share research insights and tutorials
- Link Everything: Connect papers, code, slides, and videos
- Update Often: Keep publications and projects current
Found a bug or have a feature request? Please open an issue!
Pull requests are welcome. For major changes, please open an issue first.
MIT License - feel free to use this template for your academic website!
- Design inspired by Jon Barron
- Icons from Font Awesome
- Hosted on GitHub Pages
β If this template helped you, please consider giving it a star!
Built with β€οΈ for the academic community