Skip to content

PatrickDiallo23/currency-converter

Repository files navigation

Currency Convertor

This app allows you to convert a certain amount of money from EUR to RON and vice versa:

Simulator Screen Recording - iPhone 13 - 2021-11-08 at 01 31 04

Welcome to the Currency Converter Application! This README file will guide you through the setup and running process for this project.

Table of Contents

Prerequisites

Before you begin, ensure you have the following installed on your system:

Installation

1. Clone the repository

Clone the repository to your local machine using the following command:

git clone https://github.com/PatrickDiallo23/currency-converter.git

2. Change Directory

Navigate to the project directory:

cd currency-converter

3. Install Dependencies

Run the following command to install all the necessary dependencies:

flutter pub get

4. Setup for iOS (Optional)

If you are developing for iOS, make sure you navigate to the ios directory and install the required pods:

cd ios
pod install
cd ..

Running the Application

1. Run on Android Emulator

Make sure you have an Android emulator running or a physical device connected, then run:

flutter run

2. Run on iOS Simulator (macOS Only)

Ensure that an iOS simulator is running or a physical device is connected, then execute:

flutter run

3. Run on Web

You can also run the application on the web (Chrome recommended) using:

flutter run -d chrome

Testing

1. Running Unit Tests

To run unit tests for the project, use the following command:

flutter test

Contributing

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

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Make your changes.
4. Commit your changes (git commit -m 'Add some feature').
5. Push to the branch (git push origin feature-branch).
6. Open a Pull Request.