This is a minimal, mobile-friendly static portfolio starter you can publish on GitHub Pages.
What’s included
index.html— single-page portfoliocss/styles.css— styling and responsive layoutjs/main.js— theme toggle, mobile nav, and year injection
Quick start
- Open this folder in VS Code and edit
index.htmlto add your name, email, bio, and projects. - Update links (GitHub, LinkedIn) and replace sample project cards.
- Initialize a Git repository, commit, and push to GitHub.
Publish on GitHub Pages (two common ways)
-
User/Organization site (username.github.io):
- Create a repository named
your-username.github.io. - Push the contents of this folder to the repository's
mainbranch. - GitHub Pages will publish automatically at
https://your-username.github.io.
- Create a repository named
-
Project site (repo pages):
- Create any repository (e.g.
portfolio). - Push the contents to the
gh-pagesbranch, or enable Pages to usemain/docs/from repository settings. - Visit
https://your-username.github.io/repositorywhen published.
- Create any repository (e.g.
Tips
- Replace placeholder text and sample project cards with real content.
- Add screenshots by placing images in an
assets/folder and referencing them inindex.html. - Use GitHub Actions to build a site if you later switch to a static site generator.
Next steps (optional)
- Convert to Jekyll, Hugo, or a React site if you need more features.
- Add analytics (Privacy-conscious) or contact form via a provider like Formspree.