You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Git2Page is a powerful portfolio builder that creates a stunning, personalized portfolio site in minutes — no coding experience required. Simply provide your GitHub username, and Git2Page will automatically generate your portfolio. Deploy to GitHub Pages with just a few clicks.
Note: After forking, replace git2page.config.ts with your own config from git2page.config.template.ts. See git2page.config.example.ts for reference.
Fork the repo — Click here to fork the repo so you have your own project to customize.
Rename the repo
To host at https://<USERNAME>.github.io, rename to username.github.io
To host at https://<USERNAME>.github.io/<REPO_NAME>, rename to <REPO_NAME>
Enable workflows — Go to your repo's Actions tab and enable workflows.
Set the base value — Open git2page.config.ts and change base:
Deploying to https://<USERNAME>.github.io → set base to '/'
Deploying to https://<USERNAME>.github.io/<REPO_NAME> → set base to '/<REPO_NAME>/'
// git2page.config.ts{base: '/',// ...}
Commit the changes — Commit to your master branch. Wait a few minutes for the CI/CD pipeline to publish your website to GitHub Pages. Check the Actions tab for progress.
Your portfolio will be live shortly. Any time you commit to master, the website updates automatically.
[!NOTE]
If Source is not set to GitHub Actions, go to Settings → Pages → Build and deployment and set it.
For a custom domain, add it in Settings → Pages → Custom domain. No CNAME file required.
[!NOTE]
If deploying with Vercel, set base to /.
As this is a Vite project, you can also host on Netlify, Vercel, Heroku, or other popular services. See the Vite deployment guide for details.
Note: For local development, replace git2page.config.ts with your own config from git2page.config.template.ts. See git2page.config.example.ts for reference.
Clone and enter the project
git clone https://github.com/zpt0/Git2Page.git
cd Git2Page
Install dependencies
npm install
Run dev server
npm run dev
Visithttp://localhost:5173/Git2Page/ in your browser.
❤️ Support
Show your support by starring this project! ★
🤝 Contributing
Contributions are welcome! Whether it's a bug fix, new feature, or improved documentation — we'd love your help.