Git Repositories

Connecting your Git repository is the core integration that unlocks codebase-aware project management in WeKraft. Once linked, tasks and issues can be mapped to codebase paths, and repository details are fed directly to your workspace.

Repositories Manager Dashboard

The Manage Repositories page (/dashboard/repositories) is accessed via the global sidebar and provides the interface for binding code repositories to WeKraft projects:

1. Interactive Search

• Filter your entire list of personal and organization repositories loaded from your connected version control account.

2. Connected Repositories Popover

Click this button to see a list of currently connected codebases:

• Active Connections: View a list of linked repositories showing which WeKraft project name each repo is currently linked to.
• Quick Workspace Teleport: Click the dashboard shortcut button next to any active connection to jump straight to that project's home screen.

3. Repository Connections Grid

• Displays all loaded repositories in a clean card layout.
• Synced repositories display a green Active Connection badge.
• Unlinked repositories display a project selection dropdown. You can choose any of your Unlinked WeKraft Projects and connect them instantly.

4. Setup Completion

• Linking a repository triggers a completion dialog confirming the connection is successful.
• Closing the dialog automatically routes you back to your main Dashboard.

Technical Integration & OAuth Sync

WeKraft relies on secure OAuth tokens to communicate with your code hosting provider's APIs:

1. Authentication: Users sign up or authenticate with their version control account. If signed up via email, they connect their account from their user profile settings.
2. Repository Listing: The platform dynamically queries the hosting provider's API to retrieve repository namespaces (owner/repo-name).
3. Caching: Git structure maps are securely cached inside the backend database to avoid hitting API rate limits. Project owners can trigger manual refreshes using the sync button inside the Heatmap view.

Next Steps

• Navigate the folder tree visually in Repository Heatmaps.
• Synchronize your local files with the Editor Extension.
• Manage task details in Tasks & Backlog.