Introduction

GitDot is a repository organization tool that brings hierarchical structure to flat repository namespaces.

The Problem

When developing multiple packages, you face a choice:

1. Monorepo: All packages in one repository. Simple at first, but version history becomes tangled, and CI/CD grows complex.

2. Multi-repo: Each package gets its own repository. Clean separation, but managing dozens (or hundreds) of repositories becomes unwieldy.

The second approach is architecturally sound, but platforms like GitHub don't support nested repository structures. GitLab offers subgroups, but with limitations—and many developers prefer GitHub for open source visibility.

The Solution

GitDot uses dot notation in repository names to create logical hierarchy:

my-org/
├── core.auth.service
├── core.auth.oauth
├── core.auth.jwt
├── api.gateway
├── api.users
└── api.orders

GitDot interprets these dots as folder separators and displays:

my-org/
├── core/
│   └── auth/
│       ├── service
│       ├── oauth
│       └── jwt
└── api/
    ├── gateway
    ├── users
    └── orders

Key Benefits

• Platform agnostic: Works with GitHub, GitLab, Gitea, and any Git hosting platform
• No migration required: Just rename your repositories—no code changes needed
• Independent versioning: Each package maintains its own version history
• Familiar structure: Navigate repositories like you navigate folders

Current Status

GitDot is in active development. The core visualization feature is complete. Planned features include:

• Group renaming and migration tools
• Repository templates with dot notation
• CLI tools for batch operations
• IDE integrations

Getting Started

1. Visit beta.gitdot.microwiseai.com
2. Sign in with GitHub or GitLab
3. Enter your organization or group name
4. View your repositories in hierarchical structure

See the Naming Convention guide for best practices.