CMPUT 301 W25 - Team NullPointers

Team Members

Name	CCID	GitHub Username
Hamidat Bello	hamidat	@hamidatb
Shahab Ibrahim	sibrahi1	@shahabibrahim1
Arden Monaghan	amonagha	@ardenmonaghan
Salim Soufi	soufi1	@ssoufii
Ogua Dumi-Leslie	ogua	@oguadumi
Mohammed Al Robiay	malrobia	@moeongit

Project Description

Moodify is a user-friendly Android app built in order to help friends and family keep track and share their moods throughout the day. By posting their many detailed mood events that include photos, descriptions, geolocation tags, and more, users can explore the emotional adventures of themselves and their loved ones, all the while creating a supportive community of Moodify-ers

Key Features

• ALL USER STORIES
• Mood Event Posting – Create mood events with a required emotional state and optional trigger or social context. Also, every entry is timestamped.
• Public & Private Sharing – Choose between posting mood events publicly for visibility or privately for personal reasons.
• User Profile Management – Maintain unique user profiles with searchable usernames and personal details.
• Mood History Feed – View your personal mood history in a reverse chronological list.
• Following & Friend Requests – Follow other users by sending requests and manage incoming requests by accepting or denying friend requests.
• Social Interactions – Comment on and like mood events. One can also view associated comments and see the comments and likes counts on a specific event.
• Advanced Filtering & Search – Filter mood events by date, emotional state, or keywords to quickly find what you're looking for.
• Geolocation Integration – Optionally attach your current location to mood events and view them on interactive maps. Friends can also view your location.
• Offline Functionality – Add, edit, or delete mood events even when offline, with changes syncing automatically when connectivity is restored.
• Multimedia Attachments – Enhance mood events with photographs (with file size constraints) for a better storytelling experience.
• Consistent Visual Cues – Use consistent emoticons and color coding on maps and mood cards to represent each emotional state across the app.
• Real-Time Notifications – Receive live push-notifications for friend requests and fresh mood events from people you follow.

Setup Instructions

1. Prerequisites

   • Install Android Studio (version 4.0+).
   • Ensure you have the Java Development Kit (JDK) installed (Java 8+).

2. Cloning the Repo

   • First, Clone the project repository using Git
   • Second, Navigate into the project directory

3. Opening the Project in Android Studio

   • Launch Android Studio and select "Open an existing project"
   • Browse to your cloned repository folder and open it.

4. Sync & Build

   • Allow Android Studio to automatically sync the Gradle files.
   • Once the sync is complete, build the project using the Build option from the menu.

5. Running the App

   • Connect an Android device or start an emulator from Android Studio.
   • Run the app by clicking the RUN button, and select your target device.

Documentation

• https://github.com/cmput301-w25/project-nullpointers/wiki
• https://github.com/orgs/cmput301-w25/projects/49
• UI Mockups: https://github.com/cmput301-w25/project-nullpointers/wiki/UI-Mockup-&-StoryBoard-Sequence
• UML Class Diagram: https://github.com/cmput301-w25/project-nullpointers/wiki/UML-Class-Diagram