Awesome Open Source
Awesome Open Source

Tinode Web


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

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


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.

The app is currently available in the following languages:

  • English
  • Chinese (simplified)
  • Chinese (traditional)
  • German
  • Korean
  • Romanian
  • Russian
  • Spanish

More translations are welcome. See instructions.

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.


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, set up the project if you have not done so already.
  • Follow instructions to create a web application in your project.
  • Follow instructions at 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

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,555,917
Reactjs (72,970
Telegram (4,582
Chat (3,276
Messaging (1,222
Chat Application (1,051
Whatsapp (1,008
Messenger (793
Chatapp (265
Instant Messaging (242
Related Projects