gitmap - Local Git Repository Manager

A desktop app to discover, organize, browse, and clean local Git projects.

No more manually digging through folders or trying to remember where you cloned that one project last month. gitmap organizes local repositories, previews their contents, and helps you reclaim space from reproducible build outputs.

Screen.Recording.2025-06-27.at.1.31.06.AM.mov

Features

• Auto-discovers Git repositories in configured scan locations
• Paginates large repository lists and supports pinned repositories and custom collections
• Shows workspace storage and cleanable-space statistics
• Safely reviews and deletes known reproducible artifacts, including node_modules, Rust target, .next, .nuxt, Python environments, and common build caches
• Browses repository files with GitHub-style breadcrumbs, folders, and line-numbered text previews
• Uses language icons for detected technologies
• Supports light and dark themes, with the choice persisted locally

Setup & Installation

Prerequisites

For system dependencies and Rust installation, please refer to the official Tauri prerequisites documentation.

Node.js (Required for frontend development)

• Download and install the LTS version from Node.js website
• Verify installation:

node -v  # Should show v20.x.x or higher
npm -v   # Should show version number

Development Setup

1. Clone the Repository

git clone <repository-url>
cd gitmap

2. Install Dependencies

# Using pnpm (recommended)
pnpm install

# Using npm
npm install

3. Install Tauri CLI

# Using pnpm
pnpm add -D @tauri-apps/cli

# Using npm
npm install -D @tauri-apps/cli

4. Development Mode

# Start development server
pnpm tauri dev

# Or with npm
npm run tauri dev

Building for Production

Build for Current Platform

# Build for your current platform
pnpm tauri build

# Or with npm
npm run tauri build

Reclaiming build-disk space

Rust stores compiled dependencies, debug symbols, incremental compilation data, and app bundles in src-tauri/target/. This directory is generated and ignored by Git. To remove it safely when you are not building the app:

cd src-tauri
cargo clean

The next Rust or Tauri build will recompile dependencies.

Project Structure

├── src/                    # React frontend
│   ├── components/         # React components
│   ├── pages/             # Application pages
│   ├── hooks/             # Custom React hooks
│   └── types/             # TypeScript definitions
├── src-tauri/             # Rust backend
│   ├── src/               # Rust source code
│   └── Cargo.toml         # Rust dependencies
└── public/                # Static assets

Technologies Used

• Frontend: React + TypeScript + Vite
• Backend: Rust + Tauri
• UI: Tailwind CSS + shadcn/ui
• Icons: Lucide React + React Icons
• Font: Inter
• Build Tool: Vite
• Package Manager: pnpm