Getting Started
Get up and running with GitDot in minutes.
Prerequisites
- A GitHub or GitLab account
- At least one organization or group with repositories
Step 1: Sign In
- Visit beta.gitdot.microwiseai.com
- Click Login with GitHub or Login with GitLab
- Authorize GitDot to access your repositories
GitDot requests read-only access to view your repositories and organizations.
Step 2: Select Organization
After signing in:
- Go to the Repositories page
- Select My Organizations tab
- Choose an organization from the dropdown
Or enter an organization name directly in the Direct Input tab.
Step 3: View Structure
GitDot will fetch your repositories and display them in a tree structure:
your-org/
├── api/
│ ├── gateway
│ └── users
├── core/
│ ├── auth
│ └── database
└── web/
└── dashboard
Step 4: Rename Repositories (Optional)
To take advantage of GitDot's hierarchy, rename your repositories using dot notation:
On GitHub
- Go to repository Settings
- Change repository name from
auth-servicetoauth.service - Update any references to the old name
On GitLab
- Go to Settings → General
- Change Project name and Path
- GitLab will set up redirects automatically
Next Steps
- Read the Naming Convention guide
- Explore the Roadmap for upcoming features
- Contribute to the project