A lightweight front-end currency converter built with HTML, CSS, and JavaScript.
Currency-Convertor is a small single-page web app that lets users convert amounts between currencies in the browser. The app is implemented with plain HTML, CSS and JavaScript and is intended as a simple demo or learning project.
- Simple user interface for selecting source and target currencies and entering an amount
- Instant client-side conversion logic
- Can be configured to use an external exchange-rate API (if implemented in code)
-
Clone the repository: git clone https://github.com/yps-coder/Currency-Convertor.git
-
Open the app:
- Option A (recommended for local testing): Run a simple HTTP server from the project directory:
- Python 3:
python -m http.server 8000 - Node (http-server):
npx http-server .Then openhttp://localhost:8000in your browser.
- Python 3:
- Option B: Open
index.htmldirectly in your browser (may be sufficient for pure client-side builds).
- Option A (recommended for local testing): Run a simple HTTP server from the project directory:
If the app uses a third-party exchange-rate API, configure the API endpoint or API key in the main JavaScript file. Search the project for terms like fetch, axios, or common API names (fixer, exchangerate.host, openexchangerates) to see where to set an API key. Do not commit secret API keys to the repository.
- Add a LICENSE file (MIT recommended) if you want others to reuse this code.
- Add a short description and screenshots (or enable GitHub Pages) to provide a live demo.
- If you plan to rely on a paid API, make sure to store keys securely (not in the repo).
Contributions are welcome. Please open an issue or a pull request with proposed improvements or bug fixes.
No license is included in the repository currently. Consider adding an open-source license such as MIT.