GitHub Stars Management

miniTab's GitHub Stars management feature allows you to efficiently view, search, and manage your starred repositories on GitHub, consolidating your development resources in your new tab page.

Features

🌟 Smart Repository Management

• Complete Repository Information: Display repository name, description, star count, and primary programming language
• Real-time Sync: Direct connection to GitHub API ensures up-to-date data
• Batch Operations: Support batch selection and unstarring of repositories
• Pagination: Efficient handling of large collections of starred repositories

🔍 Powerful Search Function

• Multi-dimensional Search: Search by repository name, description, and programming language
• Real-time Filtering: Instant display of search results as you type
• Smart Matching: Fuzzy search algorithm to easily find target repositories

🎯 Convenient User Experience

• Dialog Mode: Independent dialog that doesn't interfere with main interface
• Quick Access: Optional quick access button for one-click opening
• Responsive Layout: Perfect adaptation to various screen sizes

Setup

🔑 Getting GitHub Token

To use GitHub Stars feature, you need to create a GitHub Personal Access Token:

1. Access GitHub Settings:

   • Log in to GitHub, click your avatar in top right
   • Go to "Settings" → "Developer settings" → "Personal access tokens" → "Tokens (classic)"

2. Generate New Token:

   • Click "Generate new token" → "Generate new token (classic)"
   • Fill in Note (e.g., "miniTab GitHub Stars")
   • Set expiration (recommend 90 days or no expiration)

3. Set Permissions:

   • Check public_repo (access public repositories)
   • If managing private repos, check repo (full repository permissions)
   • No other permissions needed

4. Copy Token:

   • Click "Generate token"
   • Immediately copy the generated token (shown only once)

Important Notice

GitHub Token is shown only once. Please save it securely. If lost, you'll need to regenerate.

⚙️ Configuration

Enable GitHub Stars Feature

1. Click the ⚙️ settings button in top right of miniTab
2. Switch to "GitHub" tab
3. Enable "Show GitHub Quick Button" toggle
4. Paste your token in the "GitHub Token" input field
5. Click "Test Token" to verify configuration

Token Validation

• Success: Shows green icon and username confirmation
• Failure: Shows red warning, check if token is correct

Usage Guide

📋 Basic Operations

Opening GitHub Stars Management

1. Via Quick Button: Click the GitHub icon below settings button
2. Via Settings Panel: Manage in GitHub tab

Browsing Starred Repositories

• Grid Display: Repositories shown as cards with key information
• Repository Info: Each card displays:
  • Full repository name (owner/repo)
  • Project description
  • Star count and primary programming language
  • Direct link to GitHub page

Search and Filter

1. Real-time Search: Enter keywords in search box
2. Search Scope:
   • Repository name
   • Project description
   • Programming language
3. Instant Results: Search results update in real-time

🔧 Advanced Operations

Individual Repository Management

• Unstar: Click "Unstar" button on repository card
• Visit Repository: Click external link icon to jump to GitHub
• Select Repository: Check checkbox to include in batch operations

Batch Operations

1. Select All on Page: Use the master checkbox at the top
2. Custom Selection: Individually check repositories for operations
3. Batch Unstar:
   • Select target repositories
   • Click "Bulk Unstar" button
   • Confirm operation
4. Clear Selection: Click "Clear Selection" to reset selection

Pagination

• Auto Pagination: 30 repositories per page
• Load More: Click "Load More" button at bottom
• Infinite Scroll: Smooth pagination experience

🔄 Data Management

Refresh Data

• Manual Refresh: Click refresh button next to search box
• Auto Sync: Data updates in real-time after operations
• Caching: Smart caching improves loading speed

Operation Feedback

• Loading States: Shows loading animations and progress indicators
• Operation Confirmation: Confirmation prompts before batch operations
• Error Handling: Friendly prompts for network errors

Use Cases

👨‍💻 Developer Workflow

Project Research

• Technology Research: Quickly search projects of specific tech stacks
• Inspiration Collection: Browse starred design and creative projects
• Learning Resources: Organize tutorial and learning material repositories

Repository Organization

• Regular Cleanup: Batch remove projects no longer followed
• Category Management: Quickly locate different types of projects through search
• Star Maintenance: Keep starred list clean and useful

🎯 Specific Applications

Tech Stack Management

Search "react" → View all React-related projects
Search "vue" → Organize Vue.js ecosystem tools
Search "typescript" → Manage TS-related resources

Project Type Organization

Search "awesome" → View starred Awesome Lists
Search "tutorial" → Organize learning tutorial projects
Search "template" → Manage project template resources

Privacy and Security

🔒 Data Security

Token Security

• Local Storage: Token stored only in local browser
• No Upload: Token never sent to third-party servers
• Encrypted Transmission: All GitHub API requests use HTTPS encryption

Permission Control

• Minimal Permissions: Only request necessary repository read permissions
• User Control: Can revoke or regenerate token anytime
• Transparent Operations: All API calls are transparent

🛡️ Usage Recommendations

Token Management

1. Regular Updates: Recommend changing token every 90 days
2. Secure Storage: Never share token with others
3. Prompt Revocation: Immediately revoke on GitHub if compromised

Permission Settings

• Public Repositories: Usually only need public_repo permission
• Private Repositories: Enable repo permission only when necessary
• Avoid Excess: Don't grant unnecessary permissions

Troubleshooting

Common Issues

Token-related Issues

Problem: Token test fails Solutions:

1. Check if token is completely copied
2. Confirm token hasn't expired
3. Verify permission settings are correct
4. Check network connection

Problem: Cannot fetch repository list Possible Causes:

• Insufficient token permissions
• Network connection issues
• GitHub API limitations

Solutions:

1. Regenerate token with correct permissions
2. Check network connection and proxy settings
3. Wait and retry after some time

Operation Issues

Problem: Inaccurate search results Optimization Tips:

• Use more precise keywords
• Try different search angles (name vs description)
• Check spelling accuracy

Problem: Batch operations fail Solution Steps:

1. Check network connection stability
2. Reduce number of repositories per operation
3. Re-test token validity

Performance Optimization

Loading Speed Optimization

• Reasonable Pagination: Avoid loading too many repositories at once
• Smart Caching: Utilize browser caching mechanisms
• On-demand Loading: Fetch data only when needed

User Experience Optimization

• Batch Size: Recommend no more than 20 repositories per batch operation
• Network Status: Reduce concurrent operations on slow networks
• Regular Cleanup: Periodically clean unnecessary stars

Technical Details

API Integration

• GitHub API v3: Uses stable REST API
• Authentication: Personal Access Token authentication
• Rate Limits: Complies with GitHub API rate limit specifications
• Error Handling: Comprehensive error handling and retry mechanisms

Data Processing

• Real-time Sync: Operations immediately reflected in interface
• Local Caching: Reduces unnecessary API requests
• Pagination Handling: Efficient large dataset processing
• Search Algorithm: Optimized local search implementation

---

GitHub Stars management feature enables more efficient organization and utilization of development resources. Through proper configuration and usage, you can transform your GitHub stars into a powerful knowledge management tool.

If you encounter issues, please check our FAQ or contact the support team.