{"id":13740563,"url":"https://github.com/SafetyCulture/grpc-web-devtools","last_synced_at":"2025-05-08T20:31:52.040Z","repository":{"id":39551238,"uuid":"180520303","full_name":"SafetyCulture/grpc-web-devtools","owner":"SafetyCulture","description":"Chrome \u0026 Firefox Browser extension to aid gRPC-Web development","archived":false,"fork":false,"pushed_at":"2024-07-24T03:00:08.000Z","size":2328,"stargazers_count":421,"open_issues_count":58,"forks_count":59,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-04T22:06:53.685Z","etag":null,"topics":["chrome","chrome-extension","grpc-web","platform"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SafetyCulture.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-10T06:50:25.000Z","updated_at":"2025-03-27T13:32:58.000Z","dependencies_parsed_at":"2023-02-15T09:46:39.420Z","dependency_job_id":"62818d7d-c27c-43c5-ba3a-baa75850a45d","html_url":"https://github.com/SafetyCulture/grpc-web-devtools","commit_stats":{"total_commits":80,"total_committers":11,"mean_commits":"7.2727272727272725","dds":0.6125,"last_synced_commit":"6d30a442d5e95c365263d05bd93257a824479337"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SafetyCulture%2Fgrpc-web-devtools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SafetyCulture%2Fgrpc-web-devtools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SafetyCulture%2Fgrpc-web-devtools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SafetyCulture%2Fgrpc-web-devtools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SafetyCulture","download_url":"https://codeload.github.com/SafetyCulture/grpc-web-devtools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253144856,"owners_count":21861134,"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":["chrome","chrome-extension","grpc-web","platform"],"created_at":"2024-08-03T04:00:49.827Z","updated_at":"2025-05-08T20:31:51.645Z","avatar_url":"https://github.com/SafetyCulture.png","language":"JavaScript","readme":"# gRPC-Web Dev Tools\n\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)\n\n![gRPC-Web Dev Tools](screenshots/store_light_dark.png)\nNow supports dark mode.\n\n## Installation\n\n### Chrome\n\nVia\nthe [Chrome Web Store](https://chrome.google.com/webstore/detail/grpc-web-developer-tools/kanmilmfkjnoladbbamlclhccicldjaj) (\nrecommended)\n\nor\n\n1. build it with `make build`\n1. open the **Extension Management** page by navigating to `chrome://extensions`.\n1. enable **Developer Mode** by clicking the toggle switch next to \"Developer mode\".\n1. Click the **LOAD UNPACKED** button and select the extension `./build` directory.\n\n### Firefox\n\nVia [Firefox Browser Add-Ons](https://addons.mozilla.org/en-US/firefox/addon/grpc-web-developer-tools/) (recommended)\n\nor\n\n1. build and package with `make package`\n1. enter `about:debugging` in the URL bar of Firefox\n1. click **This Firefox** \u003e **Load Temporary Add-on...**\n1. select the `grpc-web-devtools.zip` extention file\n\n## Usage\n\n```javascript\nconst enableDevTools = window.__GRPCWEB_DEVTOOLS__ || (() =\u003e {\n});\nconst client = new EchoServiceClient('http://myapi.com');\nenableDevTools([\n  client,\n]);\n```\n\n\u003e NOTE: Requires that your generated client(s) use `protoc-gen-grpc-web` \u003e= 1.0.4\n\n## Example\n\nThe example uses `docker-compose` to start a simple gRPC server, JavaScript client and the Envoy proxy for gRPC-Web:\n\n```bash\nmake example-up\n```\n\nExample will be running on [http://localhost:8080](http://localhost:8080)\n\nTo stop the example:\n\n```bash\nmake example-down\n```\n\n## Connect-Web\n\ngrpc-web-devtools now also supports [connect-web](https://github.com/bufbuild/connect-web)!\n\n```ts\n// __CONNECT_WEB_DEVTOOLS__ is loaded in as a script, so it is not guaranteed to be loaded before your code.\nconst interceptors: Interceptor[] = window.__CONNECT_WEB_DEVTOOLS__ !== \"undefined\" ?\n  [window.__CONNECT_WEB_DEVTOOLS__]\n  : [];\n// To get around the fact that __CONNECT_WEB_DEVTOOLS__ might not be loaded, we can listen for a custom event,\n// and then push the interceptor to our array once loaded.\nwindow.addEventListener(\"connect-web-dev-tools-ready\", () =\u003e {\n  if (typeof window.__CONNECT_WEB_DEVTOOLS__ !== \"undefined\") {\n    interceptors.push(window.__CONNECT_WEB_DEVTOOLS__);\n  }\n});\n// Now we can use the interceptors in our transport\nconst transport: Transport = createGrpcWebTransport({\n  baseUrl: getApiHostname(),\n  interceptors,\n});\n```\nThis will also work for the connect protocol\n```ts\nconst transport: Transport = ConnectTransportOptions({\n  baseUrl: getApiHostname(),\n  interceptors,\n});\n```\n","funding_links":[],"categories":["Language-Specific","General"],"sub_categories":["Go"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSafetyCulture%2Fgrpc-web-devtools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSafetyCulture%2Fgrpc-web-devtools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSafetyCulture%2Fgrpc-web-devtools/lists"}