Nebuluv <3

What ABG or ABB (Alien Baby Girl or Boy) is for you!

A space-themed personality quiz web application built using HTMl, CSS, and JacaScript. The project provides an interactive and playful experience where users answer quiz questions to determine which planet best matches their personality. As a unique twist, after receiving their planetary match, users are shown an different images of an alien. They can then decide whether to accept or decline a romantic match with the alien, concluding the game.

Table of Contents

• Overview
• Features
• Getting Started
• Technologies Used
• Usage
• Team and Contributions
• License
• Acknowledgements

---

Overview

• Nebuluv blends fun personality quizzes with space adventure. The user navigates through a series of questions, each designed to uncover different facets of their personality. Based on the responses, a specific planet from our celestial map is chosen as a match. Once the planet is revealed, users get to meet an extraterrestrial companion. Depending on the user’s decision to accept or decline, the game wraps up with a final result, adding a quirky, humorous touch to the interactive experience.

---

Features

• Interactive Personality Quiz: A dynamic questionnaire that evaluates user responses.
• Space-Themed Results: Unique planetary matches that reflect individual personalities.
• Alien Match: A playful twist where an alien image is presented, and users can choose to romantically match.
• User-Driven Flow: Decisions from users influence the final outcome of the game.
• Responsive Design: Crafted with HTML, CSS, and JavaScript for a smooth, interactive experience across devices.

---

Prerequisites

Before running the application, ensure that you have the following installed:

• A modern web browser (e.g., Chrome, Firefox, Safari)
• A code editor (e.g., Visual Studio Code, Sublime Text) for local modifications

---

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/nebuluv.git

2. cd nebuluv
3. Launch the application Simple open the index.html file in your web browser. Alternatively, use a local server (such as Live Server for Visual Studio Code) for a better development experience.

---

Technologies Used

• HTML5: Structuring the content and elements of the application.
• CSS3: Styling and layout design to create an engaging user interface.
• JavaScript (ES6+): Implementing interactive elements, managing user data, and determining quiz outcomes.
• Version Control (Git): Collaboration and version tracking of project developments.

---

Usage

1. Launch the Application: Open index.html in your preferred web browser.
2. Quiz Flow: Answer a series of personality-based questions. The application calculates your responses to match you with a planet.
3. View Your Match: Once the quiz is completed, you will see your planet match along with an image of an alien.
4. Romantic Decision: Choose to either accept or decline the alien match. Your decision finalizes the game output.
5. Restart Option: [If implemented] Restart the quiz to try different outcomes or share the quiz with friends.

---

Team and Contributions

Nebuluv was developed collaboratively by a team of passionate developers dedicated to creative web experiences:

Kaitlyn Jao – Front-end and game flow.

Kent Nguyen – JavaScript logic and game flow.

Kai Llora – Front-end design and CSS styling.

Alex Cui-Edio - CSS styling.

We welcome contributions and feedback. Feel free to open issues or submit pull requests on our GitHub repository.

License

• This project is licensed under the MIT License. See the LICENSE file for details.