EVENTORIUM

Report Bug Demo

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation Steps
3. Available Roles and Credentials

📋 About The Project

Welcome to the Eventorium project! This is the mobile application for Eventorium, an event planning platform designed to streamline the organization of various events such as weddings, corporate gatherings, and birthday parties. Our mobile app, built for Android, offers a seamless and user-friendly experience to help you plan your events with ease.

Happy planning with Eventorium! 🎉

🔧 Built With

This project is built using the following core technologies:

🚀 Getting Started

Follow the steps below to set up and run the project locally.

📦 Prerequisites

Before you begin, ensure you have the following installed:

• 🔧 Java Development Kit (JDK) – Version 17 or later
• 📱 Android Studio – Latest stable version recommended
• 📦 Gradle – Installed via Android Studio or separately (usually handled automatically)
• 📲 Android device or emulator for testing

Optional:

• 🧪 USB Debugging enabled on your Android device (for real device deployment)

🛠️ Installation Steps

1. 🔁 Clone the repository

git clone https://github.com/anasinik/eventorium-mobile-app.git

2. 🧰 Open the project in Android Studio

• Launch Android Studio
• Click "Open"
• Select the eventorium-mobile-app directory

3. ⏳ Wait for Gradle to sync and build
4. 🔐 Update local_properties with the (backend) ip_addr and secret.

• Make sure to use the same secret value that's defined in the backend configuration.

5. 📱 Run the application

• Connect a physical Android device (with USB Debugging enabled) or start an emulator.
• Click "Run" button or use:

./gradlew installDebug

👥 Available Roles and Credentials

The system supports the following roles with corresponding credentials:

• Organizer

  • Email: organizer@gmail.com
  • Password: pera

• Service and product provider

  • Email: provider@gmail.com
  • Password: pera

• Administrator

  • Email: admin@gmail.com
  • Password: pera

• User (registered via quick registration)

  • Email: user@gmail.com
  • Password: pera

(back to top)

📸 Screenshots

🏠 Home Page and Login page

📆 Event Details View

👤 User profile view

📁 More Screenshots

You can view additional screenshots in the screenshots folder.

(back to top)