Skip to main content

Connect, Share, and Engage with Threadly

A feature-rich native Android social media application with real-time messaging, stories, and reels. Built with modern Android development practices and the MVVM architecture.

Threadly App Icon

Quick Start

Get Threadly up and running in just a few steps

1

Clone the Repository

Start by cloning the Threadly repository to your local machine:
git clone https://github.com/rashidekbal/threadly.git
cd threadly
2

Setup Backend Server

Threadly requires a running backend. Clone and configure the server:
git clone https://github.com/rashidekbal/threadlyServer
Update the BASE_URL in app/build.gradle to point to your server instance.
3

Configure Firebase

Add your google-services.json file to the app/ directory for Firebase Cloud Messaging (FCM) push notifications.
You’ll need to create a Firebase project and enable Cloud Messaging to get this file.
4

Build and Run

Open the project in Android Studio and run it on a physical device or emulator:
  • Min SDK: API Level 29
  • Target SDK: API Level 36
  • Java 11 required
Connect your device and hit Run!

Core Features

Discover what makes Threadly a powerful social media platform

Authentication

Secure login and signup with email/mobile OTP verification

Real-time Messaging

1-on-1 chat powered by Socket.IO with FCM fallback

Reels

TikTok-style scrollable video feed with smooth ExoPlayer playback

Stories

Share temporary moments with followers

Social Feed

Dynamic home feed with images, videos, and stories

Media Creation

Custom camera implementation using CameraX

Architecture & Development

Learn about the technical foundation of Threadly

MVVM Pattern

Modern Android architecture with ViewModel and LiveData

Tech Stack

Java, Room, ExoPlayer, Socket.IO, and more

Networking

Fast Android Networking and Retrofit integration

Project Structure

Organized package structure for maintainability

Database

Room Database for robust offline support

Real-time Sync

Socket.IO for live messaging and notifications

API Reference

Explore the network managers, models, and utilities

Network Managers

AuthManager, PostsManager, MessageManager, and ProfileManager

Data Models

Posts, Profile, Stories, and Media models

Utilities

ExoPlayer, Connectivity, and Permission utilities

Socket.IO Events

Real-time event handling and message delivery

Ready to Build?

Start building your own social media experience with Threadly. Follow our comprehensive guides and explore the full API reference.