{"id":17531090,"url":"https://github.com/dzervoudakes/simple-chat","last_synced_at":"2026-04-12T13:51:51.469Z","repository":{"id":80889115,"uuid":"336856068","full_name":"dzervoudakes/simple-chat","owner":"dzervoudakes","description":"No frills chat app built with React and Socket.io.","archived":false,"fork":false,"pushed_at":"2021-12-09T01:59:18.000Z","size":26904,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-03T11:51:00.093Z","etag":null,"topics":["chat","docker-compose","express","mongodb","overnightjs","react","react-with-styles","socket-io","spa","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/dzervoudakes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2021-02-07T18:12:40.000Z","updated_at":"2024-12-10T19:15:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"f23708a4-7b5a-4d83-bbb8-a6b5100e7714","html_url":"https://github.com/dzervoudakes/simple-chat","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/dzervoudakes%2Fsimple-chat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dzervoudakes%2Fsimple-chat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dzervoudakes%2Fsimple-chat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dzervoudakes%2Fsimple-chat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dzervoudakes","download_url":"https://codeload.github.com/dzervoudakes/simple-chat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246126669,"owners_count":20727594,"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":["chat","docker-compose","express","mongodb","overnightjs","react","react-with-styles","socket-io","spa","typescript"],"created_at":"2024-10-20T17:22:43.553Z","updated_at":"2026-04-12T13:51:46.426Z","avatar_url":"https://github.com/dzervoudakes.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple Chat\n\n\u003e No frills chat app built with React and Socket.io.\n\n[![client](https://github.com/dzervoudakes/simple-chat/workflows/Client/badge.svg)](https://github.com/dzervoudakes/simple-chat/actions)\n[![server](https://github.com/dzervoudakes/simple-chat/workflows/Server/badge.svg)](https://github.com/dzervoudakes/simple-chat/actions)\n[![codecov](https://codecov.io/gh/dzervoudakes/simple-chat/branch/main/graph/badge.svg)](https://codecov.io/gh/dzervoudakes/simple-chat)\n[![quality](https://app.codacy.com/project/badge/Grade/4bd2e6a40f774d2ea9300a2afd9489f5)](https://www.codacy.com/gh/dzervoudakes/simple-chat/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=dzervoudakes/simple-chat\u0026amp;utm_campaign=Badge_Grade)\n[![prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://prettier.io/)\n\n## Premise\n\nA simple, real-time chat UI with a preconfigured list of chatrooms which users can contribute to. Users can also send private messages to each other.\n\n**Notes:**\n\n- This is a full rewrite of an older project that had some nasty patterns I wanted to clean up\n- I decided to experiment with `react-with-styles` and custom components as an alternative to Material (and had a lot of fun doing it)\n- The UI is loosely inspired by Slack\n- WebSockets are awesome\n\n![demo](demo.gif)\n\n## Technologies Used\n\n- **Frontend:** React, TypeScript, Socket.io-client, CSS-in-JS theming\n- **Backend:** Node + Express, OvernightJS, Mongoose, Socket.io\n- **Database:** Docker, MongoDB\n- **CI/CD:** GitHub Actions\n\n## Local Development\n\n### Database and Server Setup\n\n- Ensure that `Docker` is installed and running\n- In your terminal, `cd` into the `server` directory and run `npm install`\n- From the project root, open your terminal and run `docker compose up`\n  - Seed data will be populated in the database automatically\n  - The server will be running on `http://localhost:3000`\n  - There are two test users by default, `Admin123` and `TestUser123`\n  - The password for each test user is `passworddd`\n\nThe `server/README.md` provides additional information on build scripts and environment variables.\n\n### Client Setup\n\n- In another terminal window, `cd` into the `client` directory and run `npm install`\n- Run `npm start`\n  - The application may be accessed in a web browser at `http://localhost:8080`\n\nThe `client/README.md` provides additional information on build scripts and environment variables.\n\n## Technical Requirements\n\n\u003e The runtime environment for this application requires `node \u003e= 14.6.0` and `npm \u003e= 6.14.7`.\n\n## Configuration\n\n\u003e This application makes use of `ESLint`, `Stylelint` and `EditorConfig`. Each of these features requires\n\u003e an extension be installed in order to work properly with IDEs and text editors such as VSCode.\n\n## Accessibility\n\n\u003e This application has been tested for accessibility via the [axe DevTools - Web Accessibility Testing](https://chrome.google.com/webstore/detail/axe-devtools-web-accessib/lhdoppojpmngadmnindnejefpokejbdd) and [Accessibility Insights for Web](https://chrome.google.com/webstore/detail/accessibility-insights-fo/pbjjkligggfmakdaogkfomddhfmpjeni) Chrome extensions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdzervoudakes%2Fsimple-chat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdzervoudakes%2Fsimple-chat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdzervoudakes%2Fsimple-chat/lists"}