https://github.com/qur786/react-native-currency-converter
Currency Converter is a mobile application built with React Native that allows users to convert between over 170 currencies. It facilitates easy calculations for currency exchange rates between different countries.
https://github.com/qur786/react-native-currency-converter
android fetch-api ios nodejs react-native reactjs rest-api typescript
Last synced: 3 months ago
JSON representation
Currency Converter is a mobile application built with React Native that allows users to convert between over 170 currencies. It facilitates easy calculations for currency exchange rates between different countries.
- Host: GitHub
- URL: https://github.com/qur786/react-native-currency-converter
- Owner: qur786
- Created: 2023-12-31T07:10:12.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-14T08:00:40.000Z (over 2 years ago)
- Last Synced: 2025-02-14T01:45:17.843Z (over 1 year ago)
- Topics: android, fetch-api, ios, nodejs, react-native, reactjs, rest-api, typescript
- Language: TypeScript
- Homepage:
- Size: 1.58 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Currency Converter
## Description
Currency Converter is a mobile application built with React Native that allows users to convert between over 170 currencies. It facilitates easy calculations for currency exchange rates between different countries.
## Features
- **Extensive Currency Database:** Access to 170+ currencies for accurate conversions.
- **Interactive UI Dropdown:** Utilizes [react-native-dropdown-picker](https://www.npmjs.com/package/react-native-dropdown-picker) for intuitive base and conversion currency selection.
- **Error Messaging:** Incorporated [react-native-snackbar](https://www.npmjs.com/package/react-native-snackbar) to display various error messages for seamless user experience.
- **Real-Time Exchange Rates:** Utilizes the [Fixer API](https://fixer.io/) to provide up-to-date exchange rates.
- **Flag Display:** Shows corresponding country flags using Unicode icons alongside currency names.
- **Caching with SQLite:** Implements caching of exchange data using [react-native-sqlite-storage](https://www.npmjs.com/package/react-native-sqlite-storage) to reduce network interactions, enabling faster calculations and avoiding unnecessary API requests.
- **Fallback Exchange Data:** Utilizes a JSON file as a fallback for exchange data when the SQLite DB has no prior data or when the Fixer API is inaccessible due to reasons such as API limit exhaustion.
- **Offline Page with SVG:** Added a visually appealing UI for the offline page using the `react-native-svg` package.
- **Interchange Base and Conversion Currencies:** Now you can easily switch between two already selected currencies to view the conversion rate and convert amounts between them.
## Installation
1. Clone the repository.
2. Run `npm install` to install dependencies.
3. Run `react-native run-android` or `react-native run-ios` to start the application.
## Usage
1. Select the base and conversion currencies from the dropdown.
2. Enter the amount to convert.
3. View the converted amount instantly.
## Dependencies
- react: 18.2.0
- react-native: 0.73.1
- react-native-dropdown-picker: ^5.4.6
- react-native-snackbar: ^2.6.2
- react-native-sqlite-storage: ^6.0.1
- react-native-svg: ^14.1.0
## API Reference
- [Fixer API](https://fixer.io/)
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.