𝗔 𝗣𝗿𝗮𝗰𝘁𝗶𝗰𝗮𝗹 𝗚𝗶𝘁 𝗪𝗼𝗿𝗸𝗳𝗹𝗼𝘄 𝗳𝗼𝗿 𝗠𝘂𝗹𝘁𝗶 𝗥𝗲𝗽𝗼𝘀𝗶𝘁𝗼𝗿𝘆 𝗣𝗿𝗼𝗷𝗲𝗰𝘁𝘀

𝗔 𝗣𝗿𝗮𝗰𝘁𝗶𝗰𝗮𝗹 𝗚𝗶𝘁-𝗪𝗼𝗿𝗸𝗳𝗹𝗼𝘄 𝗳𝗼𝗿 𝗠𝘂𝗹𝘁𝗶-𝗥𝗲𝗽𝗼𝘀𝗶𝘁𝗼𝗿𝘆 𝗣𝗿𝗼𝗷𝗲𝗰𝘁𝘀

Managing many code repositories is hard. You need a clear plan to avoid chaos.

Use this workflow to keep your teams aligned.

Pick a simple branching model:

• main: Production ready code.
• develop: Integration for testing.
• feature: Short lived task branches.

Handle dependencies with a strict protocol:

• Pin specific versions instead of using latest.
• Use lockfiles to keep environments stable.
• Maintain a compatibility matrix.

Test your code at two levels:

• Run unit tests in each repository.
• Run integration tests across all repositories.
• Use a staging environment to mirror production.

Coordinate your releases:

• Bump versions across all repos at once.
• Use clear commit messages.
• Use feat(repo) for features.
• Use fix(repo) for bugs.

Organize your work:

• Create one central epic for big features.
• Link all repo issues to this epic.
• Use labels to mark cross-repo work.

Reduce risk during deployment:

• Use feature flags to isolate changes.
• Clone specific versions to fix bugs locally.
• Track your release speed and test pass rates.

Source: https://dev.to/therizwansaleem/a-practical-git-workflow-for-multi-repository-projects-2eb6