Fable

Fable is an entertainment application that allows users to create stories, explore, and share their stories effortlessly. Share stories through photos and locations and tell them to everyone!

Project Type : Course Assignment (Personal Project)

Development Date : November 2024

Role : Mobile Developer (Android)

Technologies Used

This application was built using Git, GitHub, Android Studio, and Kotlin XML as the main framework for development. Additionally, several dependencies were used, including Room Database, Paging 3, Retrofit, Google Maps, Espresso, and more.

Challenges - Solutions - Impact

The development process of this application faced various challenges, particularly in integrating Google Maps and implementing infinite scrolling to optimize resources.

Challenges

• Displaying an unlimited list of stories from the API.
• Capturing images from the gallery and camera with a cropping feature.
• Ensuring data consistency in the UI.
• Displaying stories on a map when coordinates are available.
• Conducting testing to ensure the code is bug-free.

Solutions

• Used Room Database for local storage and Paging 3 to synchronize API data to avoid duplication and ensure unlimited scrolling.
• Implemented a swipe refresh dependency to allow users to easily fetch the latest stories.
• Used an image cropper dependency to enable photo cropping.
• Applied the MVVM architecture and ViewModel to optimize UI performance.
• Integrated Google Maps to display stories with location data.
• Conducted testing on the Home ViewModel and Login Activity.

Impact

• Provided a smooth experience for users when fetching the latest stories.
• Enabled location-based storytelling through map integration.
• Offered a photo cropping feature to let users adjust uploaded images as desired.

Lesson Learned

Through this project, I learned how to use dependencies to support infinite scrolling and display maps using Google Maps services. Additionally, I gained experience in performing testing, even if only on one ViewModel and one Activity.

• Improved understanding of Kotlin and various dependencies.
• Learned how to implement MVVM architecture for a more structured application.

Installation & Usage Guide

The installation and usage of this application are simple and quick. Users only need to follow the steps below to get started.

Installation

The installation process involves a few basic steps to ensure the application runs smoothly on the user’s device.

To get started with Fable, follow these steps:

1. Clone the repository:

   git clone https://github.com/faradaii/fable.git

2. Navigate to the project directory:

   cd fable

3. Sync the project with gradle and Install dependencies: Make sure you have the correct SDK Version installed (match it with compileSdkVersion in build.gradle).

   • If you're using android studio:

     Open File > Sync Project with Gradle Files (or the Sync Now button if appears)

   • For other environments, please refer to the specific setup instructions.

4. Run the application:

   • For Android Studio:

     Select an emulator or physical device > click the Run button (or press Shift + F10).

   • For other environments, follow the appropriate instructions.

Usage

This application allows users to create, explore, and share stories effortlessly. Users can also crop their story photos as desired and include their location in the story.

graph
A[Welcome Screen] -->|Check Login Status| B{Is User Logged In?} 
B -->|Yes| C[Home] 
B -->|No| D[Login] 
D -->|No Account?| E[Register] 
D -->|Login Success| C 
C -->|Explore Story| F[Explore Story] 
C -->|Add New Story| G[Add Story] 
C -->|Profile| H[Profile] 
C -->|Go to Maps Story| I[Maps Story] 
C -->|Logout| J[Logout] 
H -->|Logout| J

Loading

---