{"id":19501203,"url":"https://github.com/gitbookio/monorepo","last_synced_at":"2025-04-25T23:31:05.503Z","repository":{"id":73453517,"uuid":"159218168","full_name":"GitbookIO/monorepo","owner":"GitbookIO","description":"A big home for small repos","archived":false,"fork":false,"pushed_at":"2018-12-27T13:29:51.000Z","size":15,"stargazers_count":10,"open_issues_count":2,"forks_count":5,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-04T05:11:11.596Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GitbookIO.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-26T18:59:34.000Z","updated_at":"2023-07-25T14:21:42.000Z","dependencies_parsed_at":"2023-02-28T13:01:54.451Z","dependency_job_id":null,"html_url":"https://github.com/GitbookIO/monorepo","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GitbookIO%2Fmonorepo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GitbookIO%2Fmonorepo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GitbookIO%2Fmonorepo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GitbookIO%2Fmonorepo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GitbookIO","download_url":"https://codeload.github.com/GitbookIO/monorepo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250912660,"owners_count":21506865,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T22:11:51.184Z","updated_at":"2025-04-25T23:31:05.496Z","avatar_url":"https://github.com/GitbookIO.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MonoRepo\n\n\u003e A big home for small repos\n\n`monorepo` groups multiple (sub)repos into one big repo and supports bidirectional sync (`push` and `pull`).\n\n# Setup\n\n1. Start with a new (empty) repo to be your monorepo\n2. Add a `monorepo.yml` (see [_examples/simple](https://github.com/GitbookIO/monorepo/tree/master/_examples/simple))\n3. Run `monorepo pull`\n    - This will pull the files from the subrepos\n    - Creaate `monorepo.lock` with the specific SHAs pulled in\n4. Commit the monorepo (e.g: `git commit -am \"Initial pull\"`)\n\n# CI\n\nYou can use a CI system like Travis to automate syncing between your monorepo and sub repos.\n\n## 1. Setup each subrepo to pull in new updates:\n```\ngit clone https://github.com/org/bigrepo\ncd bigrepo\nmonorepo pull\ngit add .\ngit commit -am \"Update\"\ngit push\n```\n\n## 2. Setup monorepo to dispatch changes\n\n```\ncd bigrepo\nmonorepo push\n```\n\n# Usage\n\n```\n❯ monorepo --help\nNAME:\n   monorepo - A big home for small repos\n\nUSAGE:\n   monorepo [global options] command [command options] [arguments...]\n\nVERSION:\n   0.0.0\n\nAUTHOR(S):\n   Aaron O'Mullan \u003caaron@gitbook.com\u003e\n\nCOMMANDS:\n     list, ls\n     pull\n     add\n     rm\n\nGLOBAL OPTIONS:\n   --force        Force action, may result in git force-pushes [$MONOREPO_FORCE]\n   --root value   Path to the root of the monorepo [$MONOREPO_ROOT]\n   --help, -h     show help\n   --version, -v  print the version\n```\n\n## `monorepo.yml`\n\n```yaml\n- repos:\n    - path: folder1\n      url: https://github.com/org/repo1\n      ref: master\n    - path: folder2\n      url: https://github.com/org/repo2\n      ref: v2\n```\n\n# Notes\n\n- `monorepo` should never force push to your original repos (you can use the `--force` flag if you chose to do so)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitbookio%2Fmonorepo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitbookio%2Fmonorepo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitbookio%2Fmonorepo/lists"}