https://github.com/arnold-18-cs/soulsync
SoulSync is a personalized app for couples to share their love and memories. It allows partners to send lovely quotes, cherished photos, and special moments privately, fostering deeper connections.
https://github.com/arnold-18-cs/soulsync
android-application android-studio firebase love
Last synced: 10 months ago
JSON representation
SoulSync is a personalized app for couples to share their love and memories. It allows partners to send lovely quotes, cherished photos, and special moments privately, fostering deeper connections.
- Host: GitHub
- URL: https://github.com/arnold-18-cs/soulsync
- Owner: Arnold-18-CS
- License: mit
- Created: 2024-12-28T07:36:34.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-22T10:34:10.000Z (over 1 year ago)
- Last Synced: 2025-03-04T16:16:51.697Z (over 1 year ago)
- Topics: android-application, android-studio, firebase, love
- Language: Kotlin
- Homepage:
- Size: 1.41 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# **SoulSync** ❤️
SoulSync is a personalized app for couples to share their love and memories. It allows partners to send lovely quotes, cherished photos, and special moments privately, fostering deeper connections. With a clean and customizable design, SoulSync makes every day a little more romantic.
---
## **Features** 🌟
- **Quotes Sharing**:
- Send self-written or curated quotes to your partner.
- Explore and save quotes from the web.
- **Memories Sharing**:
- Upload your own images or capture new ones instantly.
- Browse images from the web and add them to your collection.
- **Themes & Settings**:
- Customize app colors, background, and text for a unique look.
- Toggle notifications to stay updated or enjoy quiet time.
- Manage account settings, including inline editing and account deletion.
- **Offline Mode**:
- Access your quotes and memories without an internet connection.
- Seamlessly sync data with the cloud when online.
---
## **Tech Stack** 🛠️
- **Frontend**: Kotlin, Jetpack Compose, Material Design Components
- **Backend**: Firebase (Authentication, Realtime Database, Storage)
- **Offline Support**: Room Database, WorkManager
- **APIs**:
- Quotes API (e.g., [Quotable API](https://quotable.io/))
- Image API (e.g., [Unsplash API](https://unsplash.com/developers))
---
## **Screenshots** 📸
- This is the figma design link for the vision I had at the start: [Figma Design](https://www.figma.com/community/file/1454571861620169675)
| Home Page | Quotes Page | Memories Page |
|-----------------------------------------------|-------------------------------------------------|---------------------------------------------------|
|  |  |  |
---
## **Getting Started** 🚀
### **Prerequisites**
1. Android Studio installed ([Download here](https://developer.android.com/studio)).
2. Firebase project set up ([Guide here](https://firebase.google.com/docs/android/setup)).
### **Clone the Repository**
```bash
git clone https://github.com/your-username/SoulSync.git
cd SoulSync
```
### **Setup Firebase** 🔥
1. Download the `google-services.json` file from your Firebase project.
2. Place it in the `app/` directory.
### **Run the App** 🏃♂️➡️
1. Open the project in Android Studio.
2. Build and run the app on an emulator or physical device.
---
## **License** 📜
This project is licenced under the MIT License.
---
## **Acknowledgments** 🙏
- Quotable API: for curated quotes.
- Unsplash API: for beautiful, free-to-use images.
---
## **Contact** 🛂
Feel free to reach out with any questions or suggestions:
Email: ogudaarnold@gmail.com
GitHub: [Arnold-18-CS ](https://github.com/Arnold-18-CS)