Bluebubbles App

Abstract

1. Introduction

BlueBubbles is an open-source, cross-platform ecosystem of apps that brings iMessage to Android, Windows, Linux, and the web. Send messages, media, reactions, and more — all from your non-Apple devices.

2. Objective

A cross-platform app ecosystem, bringing iMessage to Android, PC (Windows, Linux, & even macOS), and Web!

This project demonstrates how Dart, Android, Flutter can be applied to a real-world Mobile App Development problem.

3. Key Features / Modules

• Send and receive typing indicators in real time
• Send tapbacks, subject lines, message effects, and replies
• Automatically mark chats as read on your Mac
• Rename group chats and manage participants

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Flutter SDK
• Android Studio or VS Code with Flutter plugin
• Android / iOS device or emulator
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/BlueBubblesApp/bluebubbles-app.git
cd bluebubbles-app

1. Download and install the BlueBubbles Server on your Mac: Server releases
2. Download the BlueBubbles client app for your platform: Client releases
3. Follow the installation guide to connect everything together
4. Google Play
5. Snap Store
6. Microsoft Store

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add push notifications with Firebase Cloud Messaging
• Add offline support with local caching
• Publish an internal test build on the Play Store

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which framework is used and why (native vs cross-platform)?
2. How is app state managed across screens?
3. Where is the data stored — locally, Firebase or a REST backend?
4. How are permissions (camera, location, storage) handled?
5. How would you publish this app to the Play Store / App Store?

9. Source Code & License

This project is developed by BlueBubblesApp and published on GitHub under the Apache License 2.0. Please follow the license terms and credit the original author when you use or modify this code.