Quick Start
Search for a GitHub User
Enter any public GitHub username in the search bar at the top of the page. You can type the username and press Enter or click the Analizar button.
View the Profile Dashboard
Once the search completes, you’ll see:
- User Profile Card (left sidebar): Avatar, bio, company, location, social links, and 4 key metrics
- Language Analytics Chart (left sidebar): Donut chart showing the most-used programming languages
- Repository Grid (main area): All public repositories with filtering and sorting options
Explore Repositories
The repository grid loads automatically with 30 repositories per page. Each card shows:
- Repository name and description
- Primary programming language
- Star count and fork count
- Last update time
Understanding the Interface
Header Bar
The top navigation bar contains several important controls:- GitScope Logo: Returns you to the home screen
- Rate Limit Indicator: Shows your remaining GitHub API requests (changes color based on usage)
- Token API Button: Opens the API token configuration modal
- Theme Toggle: Switches between light and dark mode
The rate limit indicator uses color coding:
- 🟢 Green: More than 50% of requests remaining
- 🟡 Yellow: Between 20% and 50% remaining
- 🔴 Red: Less than 20% remaining
User Profile Card
The left sidebar displays comprehensive user information:- Profile Details: Avatar, name, username, and bio
- Contact Info: Company, location, website, and Twitter handle (when available)
- Activity Metrics:
- Total public repositories
- Follower count
- Following count
- Public gists
Repository Grid
The main content area shows all repositories with:- Visual Indicators: Fork and archived badges
- Language Tags: Color-coded primary language
- Engagement Metrics: Stars, forks, and last update time
- Pagination Controls: Navigate through pages of 30 repositories
Adding a GitHub API Token
By default, GitHub limits unauthenticated requests to 60 per hour. Adding a personal access token increases this to 5,000 requests per hour.Open the Token Modal
Click the Token API button in the header bar to open the token configuration modal.
Generate a GitHub Token
Click the “Crear token en GitHub” link in the modal to open GitHub’s token creation page.You’ll need to select these scopes:
- ✅
public_repo - ✅
read:user
Switching Themes
GitScope supports both light and dark themes:- Click the moon 🌙 or sun ☀️ icon in the header
- Your preference is automatically saved
- The theme persists across sessions
Best Practices
Optimizing API Usage
Optimizing API Usage
- Add an API token to avoid hitting rate limits
- Monitor the rate limit indicator in the header
- The reset time is shown when hovering over the rate limit display
Efficient Profile Analysis
Efficient Profile Analysis
- Use filters to narrow down repositories before browsing
- Sort by stars to see the most popular projects first
- The language chart analyzes the top 12 repositories automatically
Understanding Metrics
Understanding Metrics
- Repository sizes are displayed in MB (megabytes)
- Time indicators use relative format: “hoy” (today), “ayer” (yesterday), “hace Xd” (X days ago)
- Fork badges indicate repositories copied from other projects
Common Workflows
Discovering New Projects
- Search for a well-known developer in your technology area
- Sort their repositories by stars to see popular projects
- Click repositories to view recent commit activity
- Use the “Ver en GitHub” button to explore the full repository
Comparing Developer Profiles
- Search for the first developer and note their metrics
- Observe the language distribution and repository count
- Search for the second developer to compare
- Look at follower counts, repository counts, and dominant languages
Researching Technologies
- Search for the creator of a framework or library
- View the language analytics chart to see their technology stack
- Filter repositories by stars to find their most impactful projects
- Review commit history to see development activity
Troubleshooting
User Not Found Error
User Not Found Error
- Verify the username is spelled correctly
- Ensure the user has a public GitHub profile
- Check that the username exists on github.com
Rate Limit Exceeded
Rate Limit Exceeded
- Add a GitHub API token to increase your limit
- Wait until the reset time shown in the rate limit indicator
- The limit resets hourly
Slow Loading
Slow Loading
- Large profiles with many repositories may take longer to load
- The language chart fetches data for the top 12 repositories in parallel
- Results are cached to improve performance on subsequent views
Empty Commit Panel
Empty Commit Panel
- Some repositories may have restricted commit history
- Empty repositories show “No hay commits disponibles”
- Check the repository on GitHub for more information
Next Steps
Now that you understand the basics:- Learn about Filtering and Sorting Repositories
- Explore Viewing Commit History
- Master Understanding Language Charts