BlinkChat is designed for private, real-time conversations where messages are automatically deleted after exiting the chat screen. The chat only starts when both people are present, making it feel like talking face-to-face, but online.
Whether you join through a secure guest mode via a shared link or authenticate to chat with your contacts, there is no message history, no data storage, and zero digital footprint left behind. It's ideal for confidential discussions, quick one-time chats, or anything where privacy really matters.
- End-to-End Encryption (E2EE): Messages and image URLs are encrypted using symmetric cryptographic keys before being synced to the cloud.
- Ephemeral Messaging: Messages and images are automatically wiped from Firebase and AWS S3 the exact moment the chat session is terminated.
- Presence-based Match: A conversation only begins when both participants are actively present in the chat room.
- Guest Mode & Mobile Verification: Start chatting anonymously via a magic link or securely verify your mobile number to connect with your address book contacts.
- Secure Image Sharing: Share photos instantly using modern CameraX integration. Images are uploaded to temporary AWS S3 buckets and deleted completely after the session.
- Push Notifications: Stay connected gracefully with Firebase Cloud Messaging (FCM) alerts when someone initiates a secure room.
- Language: Kotlin
- UI Toolkit: Jetpack Compose & Material 3
- Architecture: MVVM (Model-View-ViewModel) + Clean Architecture principles
- Dependency Injection: Dagger-Hilt
- Local Storage: Room Database for offline contact resolution
- Networking: Retrofit & OkHttp
- Hardware Integration: CameraX API for photo capture
- Firebase Authentication: For robust Telephone Number Verification & Anonymous Guest Login.
- Firebase Firestore: Provides real-time synchronization of encrypted messages, typing indicators, and presence states.
- Firebase Cloud Messaging (FCM): For low-latency push notifications.
- Amazon Web Services (AWS) S3: Used as a secure, temporary bucket for sharing images without permanent app-server footprint.
Below is a high-level representation of how the application securely mediates between the user and cloud layers.
graph TD
subgraph Client App
A[UI - Jetpack Compose] --> B[ViewModels]
B --> C[Repositories]
C --> D[Room DB - Local Data]
C --> E[Crypto Utils - AES Encryption]
end
subgraph Firebase Infrastucture
C -- Real-time sync --> F[Firestore Database]
C -- OTP / Guest Login --> G[Firebase Auth]
F -- Triggers --> H[Cloud Functions]
H -- Push Notify --> I[FCM]
end
subgraph AWS Cloud
C -- Upload/Delete Images --> J[Amazon S3 Bucket]
end
Our data flow ensures complete ephemerality and zero-knowledge synchronization across participants.
sequenceDiagram
participant UserA as Initiator
participant Firebase as Firestore
participant AWS as AWS S3
participant UserB as Recipient
UserA->>Firebase: Create Room & Generate Crypto Key
Firebase-->>UserA: Room ID Initialized
UserA->>UserB: Share Room Link / Notify via FCM
UserB->>Firebase: Join Room with Room ID
Firebase-->>UserA: Presence Synced (Both Active)
Note over UserA,UserB: Active Chat Session
UserA->>Firebase: Send Encrypted Message
Firebase-->>UserB: Receive & Decrypt Message
UserA->>AWS: Upload CameraX Image
AWS-->>UserA: Return S3 Image URL
UserA->>Firebase: Sync Encrypted Image URL
Firebase-->>UserB: Decrypt URL & Load Image
UserA->>Firebase: Exit Chat Room
Firebase->>Firebase: Immediately Delete Encrypted Messages
Firebase->>AWS: Trigger Secure Image Deletion from S3
Firebase-->>UserB: Chat Session Ended & Wiped
To explore the codebase or run the application locally, follow these setup instructions.
- Android Studio Ladybug (or newer recommended)
- A Firebase Project with Authentication, Firestore, and Cloud Messaging enabled.
- An AWS Account with an S3 Bucket created and a Cognito Identity Pool configured for unauthenticated access.
-
Clone the repository:
git clone https://github.com/amEya911/BlinkChat.git
-
Open the project: Launch Android Studio and open the cloned repository.
-
Firebase Configuration:
- Register the application in your Firebase console.
- Download the
google-services.jsonfile and place it inside theapp/directory of the project.
-
AWS & Auth Variables Configuration:
- Navigate to the
app/src/main/java/eu/tutorials/blinkchat/utilpackage. - Create a Kotlin object file named
Ids.kt. - Add your specific credentials from AWS and Firebase:
package eu.tutorials.blinkchat.util object Ids { const val IDENTITY_POOL_ID = "YOUR_IDENTITY_POOL_ID" // For AWS Cognito S3 Access const val ACCESS_TOKEN = "YOUR_FIREBASE_ACCESS_TOKEN" const val FCM_URL = "YOUR_FIREBASE_FCM_URL" }
- Navigate to the
-
Build and Run:
- Sync the Gradle files.
- Run the app on an Android emulator or a physical device!
Built with ❤️ focusing on secure, private communications.
