A modern Telegram-inspired messaging application built using Flutter and Django, focused on realtime communication, clean architecture, and scalable system design.

This project recreates the core experience of the latest Telegram Android application, combining modern mobile UI with a realtime backend infrastructure.

✨ Main Goals

• 💬 Private messaging
• 👥 Groups & Channels
• 🎥 Media messaging
• ⚡ Realtime synchronization
• 🎨 Telegram-style modern UI
• 🧱 Scalable backend architecture

• Flutter (Dart)
• Riverpod — State Management
• go_router — Navigation
• Dio — Networking Layer
• WebSockets — Realtime Communication
• Material 3 UI

• Django
• Django REST Framework
• Django Channels
• Redis (Realtime Layer)
• PostgreSQL (Database)

The application follows Clean Architecture principles.

lib/
├── core/        # themes, constants, utilities
├── features/    # auth, chats, profile modules
├── shared/      # reusable widgets & models
├── services/    # API & websocket services
└── ui/          # screens & layouts

telegram_backend/
├── users/
├── chats/
├── messaging/
└── config/

• Real-time text messaging
• Message status (Sent ✓ Delivered ✓✓ Read ✓✓)
• Reply & Edit messages
• Chat synchronization

• Member roles & permissions
• Invite system
• Group administration tools

• Broadcast messaging
• Subscriber system
• Post statistics

• Images
• Videos
• Voice messages
• Video circle messages
• File sharing

• Authentication
• User profiles
• Privacy settings
• Online presence tracking

git clone https://github.com/javlonovic/telegram
cd telegram-clone

Install dependencies:

flutter pub get

Run application:

flutter run

Create virtual environment:

python -m venv .venv
source .venv/bin/activate

Install requirements:

pip install -r requirements.txt

Run migrations:

python manage.py migrate

Start backend server:

python manage.py runserver

Create a .env file:

DEBUG=True
SECRET_KEY=your_secret_key
DATABASE_URL=postgresql://user:password@localhost/db
REDIS_URL=redis://127.0.0.1:6379

Inspired by the latest Telegram Android design:

• Minimal interface
• Smooth animations
• Fast navigation
• Media-first messaging
• Clean typography

🚧 Coming Soon

This project demonstrates:

• Large-scale Flutter architecture
• Realtime messaging systems
• WebSocket integration
• Backend scalability concepts
• Production mobile UI design

🚧 Active Development — Phase 1 (Foundation)

Ideas, suggestions, and discussions are welcome.

MIT License