From 811c35bbd5920e57e5cbd617641a7b233c7500e7 Mon Sep 17 00:00:00 2001 From: Gary Date: Wed, 3 Jan 2024 18:41:17 -0800 Subject: [PATCH] main: prelim update to documention. --- README.md | 76 +++++++++++++-------------------------- package.json | 6 ++-- src/pages/About/About.tsx | 2 +- 3 files changed, 28 insertions(+), 56 deletions(-) diff --git a/README.md b/README.md index 6ad61b6..8720691 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ ![RemnantChat logo](./public/logo/logo.svg) -RemnantChat is a free (as in both price and freedom) communication tool. Designed to be the simplest way to connect with others privately and securely, it is: +RemnantChat is a free (as in both price and freedom) communication tool. It is forked from the platform ChitChatter [see the upstream project](https://github.com/jeremyckahn/chitchatter/blob/develop/README.md). Designed to be the simplest way to connect with others privately and securely, it is: - Fully open source (licensed under [GPL v2](./LICENSE)) - Peer-to-peer @@ -19,11 +19,11 @@ RemnantChat uses the [Create React App](https://github.com/facebook/create-react ## Status -- [![Known Vulnerabilities](https://snyk.io/test/github/jeremyckahn/RemnantChat/badge.svg?targetFile=package.json)](https://snyk.io/test/github/jeremyckahn/RemnantChat?targetFile=package.json) +TBA ## How to use it -Open https://RemnantChat.im/ and join a room to start chatting with anyone else who is in the room. By default, room names are random [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier)s that are generated client-side. To privately communicate with someone, it is recommended to join one of these randomly-generated rooms and share the URL (via the "🔗" button at the top of the page) to whomever you wish to communicate with via a secure medium of your choosing (such as [Burner Note](https://burnernote.com/) or [Yopass](https://yopass.se/)). Your user name will be presented to you, and it would be good to share that with who you will be chatting with beforehand so they know they're talking to you. +Open https://remnant.chat/ and join a room to start chatting with anyone else who is in the room. By default, room names are random [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier)s that are generated client-side. To privately communicate with someone, it is recommended to join one of these randomly-generated rooms and share the URL (via the "🔗" button at the top of the page) to whomever you wish to communicate with via a secure medium of your choosing (such as [Burner Note](https://burnernote.com/) or [Yopass](https://yopass.se/)). Your user name will be presented to you, and it would be good to share that with who you will be chatting with beforehand so they know they're talking to you. ## Features @@ -47,19 +47,19 @@ Open https://RemnantChat.im/ and join a room to start chatting with anyone else - Messages are never persisted to disk. When you leave a peer room, messages are cleared from memory and cannot be retrieved. - RemnantChat is an entirely client-side communication app. It uses public WebTorrent servers to establish peer connections and STUN/TURN relay servers when direct peer-to-peer connections cannot be established, but there is no RemnantChat API server. - No analytics, tracking, or telemetry of any kind. -- This is a community-driven and unfunded project that makes no money. The users come first and there is no corporate influence or financial interest involved. +- This is a Christian community-driven project. ## Why another chat app? -There is no shortage of user-friendly chat apps available, but they rely on a central service to facilitate communication. It is difficult to trust these central services, as commercial interests and [government pressure](https://www.npr.org/2022/08/12/1117092169/nebraska-cops-used-facebook-messages-to-investigate-an-alleged-illegal-abortion) can compel service operators to work against the best interest of the users. Even when user data is handled in good faith by service operators, the possibility remains that [encrypted data held at rest may be decrypted](https://www.cbsnews.com/news/fbi-may-have-found-way-to-unlock-san-bernardino-shooters-iphone/) against the user's will. +There is no shortage of user-friendly chat apps available, but they rely on a central service to facilitate communication. It is difficult to trust these central services. Even when user data is handled in good faith by service operators, the possibility remains that encrypted data held at rest may be decrypted against the user's will. -RemnantChat designs around these risks with a [web meshe architecture](https://dev.to/jeremyckahn/taking-the-power-back-with-web-meshes-omg). There is no central service operator that stores or potentially mishandles communication data. Some services are required to establish an initial connection between peers, but otherwise the app uses direct peer-to-peer communication for everything. Any services that are used by RemnantChat have no association with the project and are publicly available for all to use. +RemnantChat designs around these risks with a web mesh architecture. There is no central service operator that stores or potentially mishandles communication data. Some services are required to establish an initial connection between peers, but otherwise the app uses direct peer-to-peer communication for everything. Any services that are used by RemnantChat have no association with the project and are publicly available for all to use. ## Use cases RemnantChat offers a private and secure solution for: -- Organizing groups of people, such as unions or political movements +- Churches - Conveniently moving text or data from one device to another - Video chatting with friends and family across operating systems (such as Android and iOS) - IT troubleshooting via screen sharing @@ -73,25 +73,19 @@ RemnantChat offers a private and secure solution for: ### 💻️ Project status -I consider RemnantChat feature-complete inasmuch it does all the things I personally need it to do. I don't have specific plans to add significant functionality in the future, but I may do so if it seems fun to me at the time. **I am committed to fixing any significant bugs** that are reported, so please [open an issue](https://github.com/jeremyckahn/RemnantChat/issues/new) if you discover one! Aside from that, RemnantChat is effectively in maintenance mode for the foreseeable future. +Please [open an issue](https://githaven.org/shiloh/RemnantChat/issues/new) if you discover a bug. -If you would like a feature to be implemented and are willing to pay a development cost to ensure it gets done, please file a GitHub issue describing the feature and indicate that you are willing to compensate for the work. If you are not willing to pay, please open a GitHub issue regardless. I may implement it if it seems fun to do so, but other members of the community may also step up to implement it via Pull Requests. +If you would like a feature to be implemented please file a GitHaven issue describing the feature. If you are not able to work on it yourself other members of the community may step up to implement it via Pull Requests. -I will always make time support Pull Requests from others. If you're willing to put in the work to improve RemnantChat, I am willing to help shepherd that work along and get it shipped. +We will always make time to support Pull Requests from others. If you're willing to put in the work to improve RemnantChat, we are willing to help shepherd that work along and get it shipped. If you don't agree with the direction of the project, you are welcome to fork RemnantChat and take it in another one. -### 🏗️ Support and custom development - -I'm willing to do paid installations and customizations of RemnantChat for your needs. If you'd like to contract me to make a version of RemnantChat that is custom built for you, please email me at jeremyckahn@gmail.com and let me know what you have in mind to get started. - ---- - ## Veracity -The core of RemnantChat's security model is the fact that it is fully open source. You are free (and encouraged) to fully audit the project source code and infrastructure. Not only is the source code available under the terms of the [GPL](./LICENSE), but [all build logs are publicly accessible](https://github.com/jeremyckahn/RemnantChat/actions/workflows/pages/pages-build-deployment) as well. +The core of RemnantChat's security model is the fact that it is fully open source. You are free (and encouraged) to fully audit the project source code and infrastructure. -If you would like to verify that the app hosted at https://RemnantChat.im/ is the one that is hosted on GitHub, you can use `dig`: +If you would like to verify that the app hosted at https://remnant.chat/ is the one that is hosted on GitHaven, you can use `dig`: ``` $ dig RemnantChat.im @@ -115,24 +109,21 @@ jeremyckahn.github.io. 231 IN A 185.199.109.153 jeremyckahn.github.io. 231 IN A 185.199.108.153 ``` -To examine the static assets that are served to end users, you can audit the [`gh-pages` branch](https://github.com/jeremyckahn/RemnantChat/tree/gh-pages). - ## Project roadmap -See the full ticket backlog [here](https://github.com/users/jeremyckahn/projects/1). +TBA ## Environments -- Production environment: https://RemnantChat.im/ - - Mirror: https://RemnantChat.vercel.app/ (note that peers cannot connect across domains) -- Staging: https://RemnantChat-git-develop-jeremyckahn.vercel.app/ +- Production environment: https://remnant.chat +- Staging: ## SDK You can use the official RemnantChat SDK to embed the app as a [Web Component](https://developer.mozilla.org/en-US/docs/Web/API/Web_components) called ``. ```html - + ``` @@ -156,6 +147,8 @@ As well as the following [standard `