BlackBird

A fast, secure, and intuitive local network messenger for seamless communication.

Version : 0.7.5 Beta

---

✨ Key Features

• Offline Messaging: Communicate directly within your local network without internet access.
• Multi-Platform: Currently available for Windows and Linux. Android support is stable, with iOS and macOS versions coming soon.
• Dynamic Theming: Switch effortlessly between light and dark modes.
• Easy Contact Management: Simple interface for adding and managing chat partners.
• Adaptive Design: Enjoy a consistent experience across desktop and mobile devices.
• Automatic Updates: Stay current with the latest features via in-app update checks.

---

🚀 Get Started in Minutes

Prerequisites

Ensure you have the Flutter SDK installed and set up. Flutter Installation Guide

Installation

1. Clone the repository:

   git clone https://github.com/hosivay/blackbird.git
   cd blackbird

2. Install dependencies:

   flutter pub get

3. Run the app:

   # For desktop (Windows/Android):
   flutter run -d <device-name>

Usage

1. Launch BlackBird and note your local IP address.
2. Add a new chat partner by clicking the "Add" button and entering their name and IP address.
3. Start chatting instantly by selecting a contact from your list.

---

💡 Future Enhancements

• Voice and Video Calls: Direct voice and video communication within your local network.
• Robust File Transfer: Seamless sharing of documents and media.
• Group Conversations: Create and manage group chats.
• Enhanced Security: Implement end-to-end message encryption.

---

🛠️ Built With

• Flutter & Dart
• GetX (State Management)
• Hive (Local Database)
• NetworkInfoPlus (Network Utilities)
• HTTP & URL Launcher (Update Checks)
• FlexColorScheme (Theming)

---

🤝 Contribute

We welcome your contributions!

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'feat: Add AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

Please consider adding a CONTRIBUTING.md and CODE_OF_CONDUCT.md for detailed guidelines.

---

📄 License

Please include a LICENSE.md file to specify the licensing for this project.

---

📞 Contact

Hossein Valipour - hosivay@gmail.com / hosivay@outlook.com