{"id":17668585,"url":"https://github.com/evanshortiss/rhmap-websockets-client","last_synced_at":"2026-04-11T00:13:35.027Z","repository":{"id":66153936,"uuid":"100290729","full_name":"evanshortiss/rhmap-websockets-client","owner":"evanshortiss","description":"socket.io based chat application built using Ionic and Angular 4 plus Red Hat Mobile SDK","archived":false,"fork":false,"pushed_at":"2017-08-14T19:58:25.000Z","size":3009,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-05T15:13:54.427Z","etag":null,"topics":["angular","chat-application","cloud-application","cordova","ionic","mobile","rhmap","socket-io","socket-io-client","sockets"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/evanshortiss.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":"2017-08-14T17:04:52.000Z","updated_at":"2017-08-17T17:53:17.000Z","dependencies_parsed_at":"2023-04-20T11:58:33.264Z","dependency_job_id":null,"html_url":"https://github.com/evanshortiss/rhmap-websockets-client","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evanshortiss%2Frhmap-websockets-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evanshortiss%2Frhmap-websockets-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evanshortiss%2Frhmap-websockets-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evanshortiss%2Frhmap-websockets-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evanshortiss","download_url":"https://codeload.github.com/evanshortiss/rhmap-websockets-client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246321450,"owners_count":20758643,"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":["angular","chat-application","cloud-application","cordova","ionic","mobile","rhmap","socket-io","socket-io-client","sockets"],"created_at":"2024-10-23T23:23:08.998Z","updated_at":"2025-12-30T23:16:54.364Z","avatar_url":"https://github.com/evanshortiss.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## RHMAP WebSocket Client Application\nThis is the corresponding application to the WebSocket server that can be found\n[here](https://github.com/evanshortiss/rhmap-websockets-cloud).\n\n## Technology Stack\n\n* Angular v4\n* Ionic v3\n* socket.io v2\n\n## Prerequisites\n\n* Node.js v4.4.3 or higher\n* npm v4 (newer versions are likely ok also)\n* Ionic CLI v3.7.0 (this is the only tested version)\n* Cordova CLI v6.5.0 (this is the only tested version)\n\n\nIf you need to install node.js then [nvm](https://github.com/creationix/nvm) is\na great way to do so since it will allow you to run multiple node.js versions\nconcurrently on the same machine across different terminal sessions.\n\nTo install the correct npm version, Ionic, and Cordova run the following:\n\n```\nnpm i npm@4 -g\nnpm i ionic@3.7 -g\nnpm i cordova@6.5 -g\n```\n\n\n## Usage\nRun the following commands to clone and start the client.\n\n```\ngit clone $REPO_URL websocket-client\ncd websocket-client\nnpm install\nnpm run ionic:serve\n```\n\nThe application should have started in your default web browser, but Chrome and\nthe iOS WebView are the only browsers tested. Here's what it will look like if\nusing the Chrome DevTools device emulation:\n\n![](https://raw.githubusercontent.com/evanshortiss/rhmap-websockets-client/master/screenshots/chrome-devtools.png)\n\n### Communicate with a Local Node.js Cloud Application\nYou will also need to run the Cloud Application in another terminal then append\n`?url=http://localhost:8001` to the URL this application is served in your\nbrowser. For example `http://localhost:8100?url=http://localhost:8001. This will\nallow the client to communicate with your local Node.js Cloud Application.\n\n### Communicate with a Node.js Server on RHMAP\nTo have the application communicate with an instance of the Node.js server\ndeployed on Red Hat Mobile Application Platform you'll need to fill in the\nvalues in `www/fhconfig.json`. You can generate these values from the\n_Connections_ screen for a given Project on RHMAP as shown:\n\n![](https://raw.githubusercontent.com/evanshortiss/rhmap-websockets-client/master/screenshots/rhmap-connections.png)\n\n## Issues\nAttempting to run this template on iOS Simulator can encounter issues due to a\nbug with the `ios-sim` module included in Cordova the generated\n`platforms/ios/cordova/node_modules` folder. The error is like so:\n\n```\nError: Cannot read property 'replace' of undefined\n```\n\nWe've already included the updated `ios-sim` in the `package.json` of this\nproject, but you need to run the following command to ensure the correct\n`ios-sim` is used.\n\n```\nrm -rf platforms/ios/cordova/node_modules/ios-sim\n```\n\nOr just use the included script like so to work around it:\n\n```\nnpm run emulate-ios\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevanshortiss%2Frhmap-websockets-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevanshortiss%2Frhmap-websockets-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevanshortiss%2Frhmap-websockets-client/lists"}