Overview
GitFolio transforms your GitHub profile into a professional portfolio website. This guide walks you through the complete onboarding process, from signing in to accessing your dashboard.Prerequisites
Before you begin, ensure you have:- A GitHub account with public repositories
- A valid email address
- A web browser (Chrome, Firefox, Safari, or Edge)
Sign in to GitFolio
Navigate to GitFolio
Visit the GitFolio homepage and click the Sign In button in the top navigation bar.
Choose your authentication method
GitFolio supports three sign-in options:
- GitHub (Recommended)
- Google
- Email
Sign in directly with your GitHub account for automatic data syncing.
- Click Continue with GitHub
- Authorize GitFolio to access your public profile and repositories
- Your GitHub data will be automatically imported
Connect your GitHub profile
After signing in, you’ll be redirected to the onboarding page to connect your GitHub account.Enter your GitHub URL
On the onboarding screen, you’ll see a form asking for your GitHub profile URL.Enter your GitHub URL in the format
If you signed in with GitHub, your username will be pre-filled. You can modify it if needed.
www.github.com/username and click Continue.Data analysis and import
GitFolio will now fetch and analyze your GitHub data:
- User details - Profile picture, bio, location, followers, following
- Repositories - All public repositories with metadata
- Repository metadata - Stars, forks, languages, topics, deployment links
This process typically takes 10-30 seconds depending on the number of repositories. You’ll see a progress indicator showing:
- Fetching User Details…
- Fetching Repositories…
- Processing Data…
What data is imported?
During onboarding, GitFolio imports the following from your GitHub profile:Profile information
- Username (automatically converted to lowercase)
- Profile image
- Bio
- Location
- Website URL
- GitHub profile link
- Follower and following counts
Repository data
For each public repository:- Repository name
- Description
- Topics/tags
- Programming languages (with percentage breakdown)
- Star count
- Fork count
- Repository URL
- Live deployment URL (if available)
- Creation, update, and last push dates
All repositories are set to “included” by default. You can customize which repositories appear in your portfolio from the dashboard.
Troubleshooting
Error: User already exists with the following link
Error: User already exists with the following link
This error occurs when you sign in with Google or Email, and another user has already claimed the GitHub username you’re trying to connect.Solution: Ensure you’re using the correct GitHub URL. If you previously created an account with GitHub authentication, sign in using that method instead.
Error: Invalid GitHub URL
Error: Invalid GitHub URL
The GitHub URL format is incorrect.Solution: Use the exact format
www.github.com/username or https://github.com/username. Do not include extra paths like repository names.Failed to fetch data
Failed to fetch data
GitFolio couldn’t retrieve your GitHub data.Possible causes:
- The GitHub username doesn’t exist
- Your GitHub profile is private
- Network connectivity issues
- GitHub API rate limits
No repositories imported
No repositories imported
Your profile was imported but no repositories were found.Possible causes:
- You have no public repositories
- All your repositories are private or archived
Next steps
After completing the onboarding process:Customize your template
Choose and customize a portfolio template that matches your style
Manage your content
Edit your profile, add experiences, education, and skills