sospartan / webapp

Tinode web chat using React

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Single-page chat with Tinode

Single-page web chat application for Tinode. The app is built on React. The Tinode javascript SDK has no external dependencies. Overall it's a lot like open source WhatsApp or Telegram web apps.

Although the app is generally usable, keep in mind that this is work in progress. Some bugs probably exist, some features are missing. The app was tested in the latest Chrome & Firefox only. NPM package is available.

Try possibly newer or older version live at https://web.tinode.co/.

For demo access and other instructions see here.

Installing and running

This is NOT a standalone app, this is just a frontend, a client. It requires a backend. See installation instructions.

Getting support

Internationalization

The app is fully internationalized using React-Intl. The UI language is selected automatically from the language specified by the browser. A specific language can be forced by adding #?hl=XX parameter to the URL when starting the app, e.g. https://web.tinode.co/#?hl=ru.

As of the time of this writing the following translations exist:

  • English
  • Chinese (simplified)
  • Korean
  • Russian
  • Spanish

More translations are welcome. Send a pull request with a json file with translated strings. Take a look at English, Russian, or Simplified Chinese translations for guidance.

Not done yet

  • End-to-End encryption.
  • Emoji support is weak.
  • Mentions, hashtags.
  • Replying or forwarding messages.
  • Previews not generated for videos, audio, links or docs.

Other

Push notifications

If you want to use the app with your own server and want web push notification to work you have to set them up:

  • Register at https://firebase.google.com/, set up the project if you have not done so already.
  • Follow instructions to create a web application https://support.google.com/firebase/answer/9326094 in your project.
  • Follow instructions at https://support.google.com/firebase/answer/7015592 to get a Firebase configuration object ("Firebase SDK snippet").
  • Locate firebase-init.js in the root folder of your copy of TinodeWeb app. Copy-paste the following keys from the configuration object to firebase-init.js: apiKey, messagingSenderId, projectId, appId (you may copy all keys).
  • Copy Web Push certificate (Project Settings -> Cloud Messaging -> Web configuration -> Web Push certificates) to messagingVapidKey field in firebase-init.js.
  • Double check that firebase-init.js contains the following keys: apiKey, messagingSenderId, projectId, appId, messagingVapidKey. The file may contain other optional keys.
  • Copy Google-provided server key to tinode.conf, see details here.

Responsive design

Desktop screenshot

Desktop web: full app

Mobile screenshots

Mobile web: contacts Mobile web: chat Mobile web: topic info Mobile web: start new chat Mobile web: account settings

About

Tinode web chat using React

License:Apache License 2.0


Languages

Language:JavaScript 96.9%Language:CSS 2.7%Language:HTML 0.4%