{"id":13716755,"url":"https://github.com/tylersnyder/serve-micro-cluster","last_synced_at":"2025-12-27T00:07:35.242Z","repository":{"id":79634514,"uuid":"86182955","full_name":"tylersnyder/serve-micro-cluster","owner":"tylersnyder","description":"It's like Path Alias on now, but for local development.","archived":false,"fork":false,"pushed_at":"2017-04-13T14:23:00.000Z","size":39,"stargazers_count":19,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-07T23:53:27.558Z","etag":null,"topics":["cluster","micro","microservices","nodejs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/tylersnyder.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}},"created_at":"2017-03-25T19:24:37.000Z","updated_at":"2021-10-20T21:03:16.000Z","dependencies_parsed_at":"2023-03-01T09:00:47.246Z","dependency_job_id":null,"html_url":"https://github.com/tylersnyder/serve-micro-cluster","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/tylersnyder/serve-micro-cluster","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tylersnyder%2Fserve-micro-cluster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tylersnyder%2Fserve-micro-cluster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tylersnyder%2Fserve-micro-cluster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tylersnyder%2Fserve-micro-cluster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tylersnyder","download_url":"https://codeload.github.com/tylersnyder/serve-micro-cluster/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tylersnyder%2Fserve-micro-cluster/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28065703,"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","status":"online","status_checked_at":"2025-12-26T02:00:06.189Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cluster","micro","microservices","nodejs"],"created_at":"2024-08-03T00:01:14.021Z","updated_at":"2025-12-27T00:07:35.226Z","avatar_url":"https://github.com/tylersnyder.png","language":"JavaScript","funding_links":[],"categories":["Development Tools"],"sub_categories":["Utilities"],"readme":"# serve-micro-cluster\nEasily start a local cluster of [`micro`](https://github.com/zeit/micro)-based services using a simple `rules.json` file. It's like *Path Alias* on [now](https://zeit.co/now), but for local development.\n\n### Installation\n\nInstall `serve-micro-cluster` globally.\n\n```\nnpm install -g serve-micro-cluster\n\n// or\n\nyarn global add serve-micro-cluster\n```\n\n### Usage\n\nDefine a `rules.json` file. If your file has a name other than `rules`, use the `-f` flag to let `serve-micro-cluster` know. This comes in handy if you're keeping multiple versions of your `rules` available in the same directory (development, production.)\n\n```\n{\n  \"rules\": [\n    {\n      \"pathname\": \"/accounts\",\n      \"dest\": \"./services/accounts/index.js\"\n    },\n    ...\n  ]\n}\n```\n\nYou can also define `port` and `env` variables:\n\n```\n{\n  \"rules\": [\n    {\n      ...\n      \"port\": 4000,\n      \"env\": {\n        \"SECRET_KEY\": \"supersecret\"\n      }\n    }\n}\n```\n\n\nOnce your rules are defined, you can start your microservices and proxy server using `serve-micro-cluster`.\n\n```\n  \"scripts\": {\n    \"start\": \"serve-micro-cluster\"\n  }\n```\n\nThe following options are available:\n\n - `-h`, `--host` (default `localhost`)\n - `-p`, `--port` (default `3000`)\n - `-f`, `--file` (default `rules.json`)\n\n### Example\nSee [serve-micro-cluster/example](https://github.com/tylersnyder/serve-micro-cluster/tree/master/example).\n\n### Alternatives\n - [dev-gateway](https://github.com/dimapaloskin/dev-gateway) Local development cluster with \"now\" path aliases syntax support. Allows running multiple microservices as one solid server.\n - [micro-cluster](https://github.com/zeit/micro-cluster) - Run multiple micro servers and a front proxy at a time\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftylersnyder%2Fserve-micro-cluster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftylersnyder%2Fserve-micro-cluster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftylersnyder%2Fserve-micro-cluster/lists"}