Skip to content

Ben-ayesu/Temperature_Converter_ViewModelDemo

Repository files navigation

Temperature Converter App

The Temperature Converter App is an Android application that allows users to convert temperatures between Celsius and Fahrenheit. It is built using Jetpack Compose and follows the MVVM (Model-View-ViewModel) architecture. This README provides an overview of the project and instructions for building and running the app.

Features

  • Convert Celsius to Fahrenheit and vice versa
  • Real-time conversion as the user enters the temperature
  • Clean and intuitive user interface
  • Support for dark and light themes

Technologies Used

  • Jetpack Compose: A modern toolkit for building native Android UI.
  • GitHub: Version control and source code hosting platform.
  • MVVM: Architecture pattern for separating the presentation layer from the data layer.
  • Android Studio: Integrated development environment (IDE) for Android app development.

Prerequisites

  • Android Studio 4.0 or higher
  • Android SDK
  • Kotlin

Getting Started

To get a local copy of the Temperature Converter App up and running on your machine, follow these steps:

  1. Clone the repository:
git clone https://github.com/your-username/temperature-converter-app.git
  1. Open Android Studio.

  2. Click on "Open an Existing Project" and navigate to the cloned repository.

  3. Wait for Android Studio to import the project and set up the dependencies.

Building and Running the App

  1. Connect an Android device to your development machine or set up an Android emulator.

  2. In Android Studio, select the device/emulator you want to run the app on.

  3. Click on the "Run" button or press Shift+F10 to build and run the app.

  4. Wait for the app to compile and install on the selected device/emulator.

  5. Once the app is installed, you can launch it from the device's app drawer.

Contributing

Contributions to the Temperature Converter App are welcome! If you find any bugs or have suggestions for new features, please open an issue on the GitHub repository.

If you would like to contribute code to the project, please follow these steps:

  1. Fork the repository.

  2. Create a new branch for your feature/fix:

git checkout -b my-feature
  1. Make your changes and commit them:
git commit -m "Add my feature"
  1. Push your changes to your forked repository:
git push origin my-feature
  1. Open a pull request on the main repository.

Please ensure that your code follows the project's coding style and includes appropriate tests.

License

The Temperature Converter App is licensed under the MIT License.

Contact

For any inquiries or support requests, please contact the project maintainer:

Your Name Email: [email protected]

Screenshot

Screenshot_20230225_234137

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages