https://github.com/heintayzar-hm/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.
https://github.com/heintayzar-hm/currency-for-you
api react-native redux
Last synced: 2 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/heintayzar-hm/currency-for-you
- Owner: heintayzar-hm
- License: mit
- Created: 2023-05-23T14:48:17.000Z (about 2 years ago)
- Default Branch: dev
- Last Pushed: 2023-05-26T08:22:45.000Z (about 2 years ago)
- Last Synced: 2025-02-07T23:45:58.307Z (4 months ago)
- Topics: api, react-native, redux
- Language: JavaScript
- Homepage:
- Size: 6.21 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📗 Table of Contents
- [📖 About the Project](#about-project)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [Kanban Board](#kanban-board)
- [🚀 Live Demo](#live-demo)
- [💻 Getting Started](#getting-started)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Install](#install)
- [Usage](#usage)
- [Run tests](#run-tests)
- [Deployment](#triangular_flag_on_post-deployment)
- [👥 Authors](#authors)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)
- [❓ FAQ](#faq)
- [📝 License](#license)
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
REACT
API
- A user can see the currencies
- A user can convert the currencies
- Currencies update every 30 mins
- You can see specific currencies
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:
https://github.com/heintayzar-hm/currency-for-you/assets/105173981/e8b79134-fee3-45f9-8215-1d53ffd387c7
or Link here if the above video is not working:
[YouTube](https://youtube.com/shorts/83n6Aj1IxxM)
To get a local copy up and running, follow these steps.
### Prerequisites
In order to run this project you need:
```sh
node
java
```
### Setup
Clone this repository to your desired folder:
```sh
git clone https://github.com/heintayzar-hm/currency-for-you.git
```
### Install
Install Project with:
```sh
cd currency-for-you
```
make .env file, key is just a free key and you can create yourselves one at [https://currencylayer.com/](https://currencylayer.com/)
```sh
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
👤 **Hein Tay Zar**
- GitHub: [@Hein Tay](https://github.com/heintayzar-hm)
- Twitter: [@Hein Tay](https://twitter.com/heintayzarhm)
- LinkedIn: [Hein Tay](https://www.linkedin.com/in/hein-tay-zar)
## Deployment
User can deploy yourself using:
```sh
npx react-native run-android --variant=release
```
or
```sh
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
- Deployed full version (currently api keys have problems) on Play Store
- Style more
- Add test cases
Contributions, issues, and feature requests are welcome!
Feel free to check the [issues page](../../issues/).
If you like this project, Please give it a ⭐️
Thanks [myansis](https://myansis.com/) for request
This project is [MIT](./LICENSE) licensed.