Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nikhilkumarmishra/quiz-app-android

Quiz-App Android
https://github.com/nikhilkumarmishra/quiz-app-android

Last synced: about 2 months ago
JSON representation

Quiz-App Android

Awesome Lists containing this project

README

        

# QuizApp

**QuizApp** is an Android quiz application designed to test users' knowledge with multiple-choice questions. The app displays questions, allows users to select answers, and provides feedback on their performance.

## Features

- Multiple choice questions
- Immediate feedback on answers
- Score tracking
- Navigation between questions
- Restart quiz functionality
- Final score dialog box

## Screenshots

## Installation

To get a local copy up and running follow these simple steps:

1. Clone the repository:
```sh
git clone https://github.com/your-username/QuizApp.git
```

2. Open the project in Android Studio.

3. Build the project to download dependencies and set up the environment.

4. Run the app on an emulator or a physical device.

## Usage

### Main Features

1. **Start the Quiz**: Open the app and the first question will be displayed.
2. **Select an Answer**: Tap on one of the answer buttons to select your answer.
3. **Next and Previous**: Use the "Next" and "Previous" buttons to navigate through the questions.
4. **Restart Quiz**: Tap the "Restart Quiz" button to start over.
5. **View Results**: After the last question, your score will be displayed in a dialog box.

## Code Structure

- **MainActivity.kt**: Contains the main logic for the quiz functionality.
- **activity_main.xml**: Defines the layout of the app.

### MainActivity.kt

Handles displaying questions, checking answers, and navigating between questions.

### activity_main.xml

Defines the UI layout, including question text, answer buttons, and navigation controls.

## Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## License

Distributed under the MIT License. See `LICENSE` for more information.

## Contact

Nikhil Kumar Mishra - [LinkedIn](https://www.linkedin.com/in/nikhil-kumar-mishra/)

Project Link: [GitHub](https://github.com/Nikhilkumarmishra/Quiz-App-Android)