Git X-Modules is an app for Bitbucket, that provides a server-side alternative to Git Submodules.
Git X-Modules creates and manages Git repositories that include other repositories.
An X-Module is a regular directory in a Git repository synchronized with an external repository.
A repository with X-Modules is a regular Git repository: you can clone it, push to it, create pull requests, etc.
Use cases:
- Combine multiple projects and components into a single repository for cross-project development.
- Include parts of other projects into yours.
- Share common assets across multiple projects.
- Split mono-repository.
Key benefits:
- Configure and manage X-Modules within Bitbucket Server UI.
- Include repository branches, tags, or commits as X-Modules.
- Select module sync strategy:
- include complete history with SHA-1 hashes preserved; or
- include a compact digest of a module history.
- Users follow standard Git workflow: clone, push, create new branches and pull requests; no special commands are required.
- Add Git X-Modules to your existing work environment without rebuilding it.
Git X-Modules App is compatible with both Bitbucket Server and Data Center. Bitbucket Cloud is not yet supported.