MainSpace 🚀

Your complete workspace for managing local projects and GitHub repositories directly in VS Code.

📌 One-sentence summary: MainSpace brings a card-based project manager, seamless GitHub integration, Git operations, and interactive documentation right into your editor toolbar.

🛠️ Summary of Key Features

Feature	Capabilities
Project Manager 🎯	Add, edit, organize local projects in categories with color-coded cards
GitHub Integration	Connect via OAuth, list repos, create repos, edit visibilities, delete
Git Clones 📁	Clone repositories locally, push with auto-commits, pull, manage branches
Pull Requests 🔀	Track PR status (Open/Closed/Merged) and submit PRs for forks
Public Search 🔍	Search public repos on GitHub, inspect stats, fork, or clone directly
Favorites ⭐	Mark local projects, repos, and clones for quick access
Import / Export 💾	Backup and restore your configuration as JSON
Localization 🌐	Full Portuguese (BR) and English (US) support

🚀 Quick Start & Opening MainSpace

After installing the extension, look for the MainSpace icon in the VS Code Activity Bar (left sidebar) and click Abrir MainSpace to launch the manager.

✨ Features & Usage Guide

🎯 1. Creating & Managing Local Projects

Add, organize, and open your local projects with custom colors and paths. Double-click any card to open the project in a new VS Code window.

🔍 2. Public Repository Search & Forking

Search for any public repository on GitHub directly from VS Code. Inspect stars, forks, issues, expand details, clone instantly, or create a fork into your own account with a single click.

🔑 3. GitHub OAuth Device Flow Login

Connect your GitHub account safely using GitHub OAuth Device Flow. View your avatar, repositories, stars, and manage your account seamlessly without managing personal access tokens manually.

📁 4. Git Clones, Pull/Push & Branch Management

Manage your local cloned repositories with visual status cards. Perform Git operations like pull, push, create Pull Requests, and switch or manage branches directly through an intuitive UI.

📖 5. Built-in Extension Documentation

Access complete guides, shortcuts, and usage documentation anytime through the interactive 📖 Doc tab inside the extension window.

🏷️ 6. Custom Categories

Organize your project cards into custom categories. Create, edit, and delete category tabs to keep your workspace clean and structured.

📋 Requirements

• VS Code: 1.85.0 or higher
• Git: Installed and available in system PATH (required for clone, push, pull operations)

📝 Release Notes

1.2.4

• Fixed: favorites count now displays correctly in the favorites tab.

1.2.0

• Commit and branch pagination with search (99 per page).
• Item counter (shown vs. total) in tabs (e.g. 20/80).
• More visible GitHub authorization modal (highlighted code).
• "Clear all data" option in settings (factory reset).
• Fixed: created repository card highlight now appears immediately and lasts 6 seconds.
• Fixed: favorite button tooltip (Add/Remove to favorites).
• Fixed: unintended redirect to the GitClones tab when canceling a clone.
• Fixed: wrong card was highlighted when creating a project.

1.1.0

• Added Commit and Branch pagination with search capability.
• New redesigned GitHub Auth Modal.
• Clear all local data option in settings.
• Enhanced favorite tooltips and UI polish.
• Performance improvements and bug fixes.

1.0.0

• Initial release of MainSpace.

📌 Tip: Don't forget to star the repository if MainSpace helps boost your daily developer productivity!