W.I.P. !!!! Justygram - Minimalistic Telegram client

A Telegram client with a React web interface and a Node.js backend. It works via the GramJS library (MTProto) and can be packaged as a desktop application using Tauri.

Features

• Phone number authentication with 2FA (cloud password) support
• Chat list with avatars and user status (online / last seen)
• Chat window: text messages, emoji, replies
• Voice and audio messages with a player, seeking, and waveform visualization
• Message pagination and context loading by clicking on a reply
• Real-time updates via SSE (Server-Sent Events)
• Client-side GET request caching (axios interceptors)
• Customizable interface accent color

Requirements

• Node.js 16+
• Rust and Cargo (only for building the desktop version via Tauri)

Setup

1. Get your API_ID and API_HASH at my.telegram.org → API development tools.
2. Create a .env file in the project root:

API_ID=your_api_id
API_HASH=your_api_hash
PORT=3000        # frontend port (CRA)
SERVER_PORT=3001 # API server port
BROWSER=none     # don't open the browser automatically

3. Install dependencies:

npm install

Running

Development mode

Starts both the API server (:3001) and the frontend (:3000):

npm run dev

Open in your browser: http://localhost:3000

Backend only

npm start

Frontend build

npm run build

Desktop app (Tauri)

Development mode:

npm run tauri dev

Building an installer:

npm run tauri build

Ready binaries will appear in src-tauri/target/release/bundle/.

Security

Important: the .env and .telegram-session files must never be committed to the repository or made public.