📗 Table of Contents

• 📖 About the Project
  • 🛠 Built With
    • Tech Stack
    • Key Features
  • Kanban Board
  • 🚀 Live Demo
• 💻 Getting Started
  • Setup
  • Prerequisites
  • Install
  • Usage
  • Run tests
  • Deployment
• 👥 Authors
• 🔭 Future Features
• 🤝 Contributing
• ⭐️ Show your support
• 🙏 Acknowledgements
• ❓ FAQ
• 📝 License

📖 CURRENCY FOR YOU

CURRENCY FOR YOU is a React Native app for currency tracking and conversion, using exchange rates data from the CurrencyLayer API. The app allows currency selection, amount input, and viewing exchange rates, with locally stored rates refreshed every 30 minutes. Built with React Native, it follows Clean Architecture principles

Tech Stack

REACT

• React
• Redux

API

• currencylayer.com

Key Features

• A user can see the currencies
• A user can convert the currencies
• Currencies update every 30 mins
• You can see specific currencies

(back to top)

(back to top)

🚀 Live Demo

You can see the packages in the releases section. (You might need to buy api to deploy on certain android as they do not allow http requests( the api free plan is http))

You can also see short video presentation here:

Screenrecorder-2023-05-26-14-18-42-924.mp4

or Link here if the above video is not working:

YouTube

(back to top)

💻 Getting Started

To get a local copy up and running, follow these steps.

Prerequisites

In order to run this project you need:

 node
 java

Setup

Clone this repository to your desired folder:

 git clone https://github.com/heintayzar-hm/currency-for-you.git

Install

Install Project with:

  cd currency-for-you

make .env file, key is just a free key and you can create yourselves one at https://currencylayer.com/

   API_URL = http://apilayer.net/api/
   API_KEY = 05e8c1c4278b72a5bcdd91ee2fb36ea8

• Run the following.(The command can be difference according to the systems)

   npm install
   npx react-native start

Run tests

Work In Progress

👥 Authors

👤 Hein Tay Zar

• GitHub: @Hein Tay
• Twitter: @Hein Tay
• LinkedIn: Hein Tay

(back to top)

Deployment

User can deploy yourself using:

npx react-native run-android --variant=release

or

cd android && ./gradlew assembleRelease

You will get a file at currency-for-you/android/app/build/outputs/apk/release/app-release.apk

You can run on your android

🔭 Future Features

• Deployed full version (currently api keys have problems) on Play Store
• Style more
• Add test cases

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

If you like this project, Please give it a ⭐️

(back to top)

🙏 Acknowledgments

Thanks myansis for request

(back to top)

📝 License

This project is MIT licensed.

(back to top)