Build a Simple React Currency Converter: A Beginner’s Guide

Written by

javascriptfundamentals

in

In today’s interconnected world, dealing with different currencies is a common occurrence. Whether you’re planning a trip abroad, managing international finances, or simply curious about exchange rates, a currency converter is an invaluable tool. Building your own currency converter in React not only provides a practical application but also offers a fantastic opportunity to learn and solidify your React skills. This tutorial will guide you through the process step-by-step, from setting up your project to fetching real-time exchange rates and displaying the converted amounts.

Why Build a Currency Converter in React?

React is a powerful JavaScript library for building user interfaces, known for its component-based architecture and efficient updates. Building a currency converter provides several benefits:

  • Practical Application: You create a useful tool that you can use daily.
  • Learning Experience: You get hands-on experience with core React concepts like state management, component composition, and handling API calls.
  • Portfolio Piece: It’s a great project to showcase your React skills to potential employers.
  • Customization: You have complete control over the design and features, allowing you to tailor it to your specific needs.

This tutorial is designed for beginners to intermediate React developers. We’ll break down the process into manageable steps, explaining each concept in simple terms with clear code examples.

Prerequisites

Before we begin, make sure you have the following:

  • Node.js and npm (or yarn) installed: These are essential for managing project dependencies.
  • Basic understanding of HTML, CSS, and JavaScript: Familiarity with these languages is necessary to follow along.
  • A code editor: Visual Studio Code, Sublime Text, or any other editor of your choice.

Step 1: Setting Up Your React Project

Let’s start by creating a new React project using Create React App. Open your terminal and run the following command:

npx create-react-app react-currency-converter

This command creates a new directory called react-currency-converter with all the necessary files to get you started. Navigate into your project directory:

cd react-currency-converter

Now, start the development server:

npm start

This will open your app in your default web browser, usually at http://localhost:3000. You should see the default React app.

Step 2: Project Structure and Component Setup

Let’s organize our project. We’ll create a simple component structure:

  • src/App.js: This will be our main component, handling the overall structure and state.
  • src/components/CurrencyConverter.js: This component will handle the currency conversion logic and UI.

First, let’s clear out the unnecessary code in src/App.js and update it to a functional component:

// src/App.js
import React from 'react';
import CurrencyConverter from './components/CurrencyConverter';
import './App.css'; // Import your CSS file (optional)

function App() {
  return (
    <div className="App">
      <CurrencyConverter />
    </div>
  );
}

export default App;

Next, create the CurrencyConverter.js file inside a new components folder within the src folder. This is where the core logic of our application will reside.

// src/components/CurrencyConverter.js
import React, { useState, useEffect } from 'react';

function CurrencyConverter() {
  const [fromCurrency, setFromCurrency] = useState('USD');
  const [toCurrency, setToCurrency] = useState('EUR');
  const [amount, setAmount] = useState(1);
  const [convertedAmount, setConvertedAmount] = useState(null);
  const [exchangeRate, setExchangeRate] = useState(null);
  const [currencies, setCurrencies] = useState([]);
  const [isLoading, setIsLoading] = useState(false);
  const [error, setError] = useState(null);

  // ... (We'll add the rest of the code here later)

  return (
    <div>
      <h2>Currency Converter</h2>
      {/* UI elements will go here */}
    </div>
  );
}

export default CurrencyConverter;

In this initial setup, we’ve imported the necessary modules (useState and useEffect). We’ve also defined our initial state variables using the useState hook. These variables will hold the currency codes, the amount to convert, the converted amount, the exchange rate, a list of available currencies, a loading state, and any potential errors.

Step 3: Fetching Currency Data from an API

To get real-time exchange rates, we’ll use a free API. There are many free APIs available; for this tutorial, we’ll use ExchangeRate-API. Sign up for a free API key (this is usually a quick process). Note: Free APIs often have rate limits. Be mindful of these limits when testing and developing.

Let’s add a function to fetch the exchange rates and currencies. We’ll use the useEffect hook to make the API call when the component mounts and when the currencies or from/to currencies change.

// src/components/CurrencyConverter.js
import React, { useState, useEffect } from 'react';

function CurrencyConverter() {
  const [fromCurrency, setFromCurrency] = useState('USD');
  const [toCurrency, setToCurrency] = useState('EUR');
  const [amount, setAmount] = useState(1);
  const [convertedAmount, setConvertedAmount] = useState(null);
  const [exchangeRate, setExchangeRate] = useState(null);
  const [currencies, setCurrencies] = useState([]);
  const [isLoading, setIsLoading] = useState(false);
  const [error, setError] = useState(null);

  const API_KEY = 'YOUR_API_KEY'; // Replace with your actual API key

  useEffect(() => {
    const fetchCurrencies = async () => {
      setIsLoading(true);
      setError(null);
      try {
        const currenciesResponse = await fetch(
          `https://api.exchangerate-api.com/v4/currencies`
        );
        if (!currenciesResponse.ok) {
          throw new Error(`HTTP error! status: ${currenciesResponse.status}`);
        }
        const currenciesData = await currenciesResponse.json();
        const currencyCodes = Object.keys(currenciesData);
        setCurrencies(currencyCodes);
      } catch (error) {
        setError(error.message);
      } finally {
        setIsLoading(false);
      }
    };

    fetchCurrencies();
  }, []);

  useEffect(() => {
    const fetchExchangeRate = async () => {
      setIsLoading(true);
      setError(null);
      try {
        const response = await fetch(
          `https://api.exchangerate-api.com/v6/latest?base=${fromCurrency}&symbols=${toCurrency}&apikey=${API_KEY}`
        );
        if (!response.ok) {
          throw new Error(`HTTP error! status: ${response.status}`);
        }
        const data = await response.json();
        const rate = data.rates[toCurrency];
        setExchangeRate(rate);
        setConvertedAmount(amount * rate);
      } catch (error) {
        setError(error.message);
        setConvertedAmount(null);
      } finally {
        setIsLoading(false);
      }
    };

    if (fromCurrency && toCurrency) {
      fetchExchangeRate();
    }
  }, [fromCurrency, toCurrency, amount]); // Run when these change

  // ... (UI elements will go here)

  return (
    <div>
      <h2>Currency Converter</h2>
      {/* UI elements will go here */}
    </div>
  );
}

export default CurrencyConverter;

Important: Replace 'YOUR_API_KEY' with your actual API key from the ExchangeRate-API. Make sure you keep your API key secure and do not commit it directly to a public repository.

Let’s break down the code:

  • API Key: We store the API key in a constant, but in a real-world application, you would use environment variables for security.
  • `useEffect` Hook (Currencies): This hook fetches a list of available currencies when the component mounts. It uses the fetch API to make a request to the ExchangeRate-API. The response is parsed as JSON, and the currency codes are extracted and stored in the currencies state. Error handling is included.
  • `useEffect` Hook (Exchange Rate): This hook fetches the exchange rate whenever fromCurrency, toCurrency, or amount changes. It constructs the API URL with the selected currencies. The response is parsed as JSON, the exchange rate is extracted, and the converted amount is calculated and stored in the convertedAmount state. Error handling is also included.
  • Loading State: The isLoading state variable is used to indicate whether the API call is in progress. This is used to display a loading message to the user while the data is being fetched.
  • Error Handling: The error state variable stores any errors that occur during the API calls. This allows us to display error messages to the user.

Step 4: Building the User Interface (UI)

Now, let’s create the UI elements for our currency converter. We’ll add input fields for the amount, dropdowns for selecting currencies, and a display area for the converted amount. We’ll also add a loading indicator and error messages.


// src/components/CurrencyConverter.js
import React, { useState, useEffect } from 'react';

function CurrencyConverter() {
  // ... (State variables and API key as defined previously)

  // Event Handlers
  const handleFromCurrencyChange = (e) => {
    setFromCurrency(e.target.value);
  };

  const handleToCurrencyChange = (e) => {
    setToCurrency(e.target.value);
  };

  const handleAmountChange = (e) => {
    const value = parseFloat(e.target.value);
    if (!isNaN(value)) {
      setAmount(value);
    } else {
      setAmount(0);
    }
  };

  // ... (useEffect hooks as defined previously)

  return (
    <div style={{ padding: '20px', border: '1px solid #ccc', borderRadius: '5px', maxWidth: '400px', margin: '20px auto' }}>
      <h2>Currency Converter</h2>

      {error && <p style={{ color: 'red' }}>Error: {error}</p>}

      {isLoading && <p>Loading...</p>}

      <div style={{ marginBottom: '10px' }}>
        <label htmlFor="amount">Amount:</label>
        <input
          type="number"
          id="amount"
          value={amount}
          onChange={handleAmountChange}
          style={{ marginLeft: '10px', padding: '5px', border: '1px solid #ccc', borderRadius: '3px' }}
        />
      </div>

      <div style={{ marginBottom: '10px', display: 'flex', alignItems: 'center' }}>
        <label htmlFor="fromCurrency" style={{ marginRight: '10px' }}>From:</label>
        <select
          id="fromCurrency"
          value={fromCurrency}
          onChange={handleFromCurrencyChange}
          style={{ padding: '5px', border: '1px solid #ccc', borderRadius: '3px' }}
        >
          {currencies.map((currency) => (
            <option key={currency} value={currency}>{currency}</option>
          ))}
        </select>
      </div>

      <div style={{ marginBottom: '10px', display: 'flex', alignItems: 'center' }}>
        <label htmlFor="toCurrency" style={{ marginRight: '10px' }}>To:</label>
        <select
          id="toCurrency"
          value={toCurrency}
          onChange={handleToCurrencyChange}
          style={{ padding: '5px', border: '1px solid #ccc', borderRadius: '3px' }}
        >
          {currencies.map((currency) => (
            <option key={currency} value={currency}>{currency}</option>
          ))}
        </select>
      </div>

      {convertedAmount !== null && !isLoading && !
        error && (
        <p>{amount} {fromCurrency} = {convertedAmount.toFixed(2)} {toCurrency}</p>
      )}
    </div>
  );
}

export default CurrencyConverter;

Key UI components and functionalities include:

  • Amount Input: A number input field for the user to enter the amount they want to convert. The handleAmountChange function updates the amount state. Input validation is included to prevent non-numeric values.
  • Currency Select Dropdowns: Two select elements (dropdowns) for choosing the source and target currencies. The handleFromCurrencyChange and handleToCurrencyChange functions update the respective states (fromCurrency and toCurrency). The options are populated dynamically from the currencies array fetched from the API.
  • Display Converted Amount: A paragraph that displays the converted amount. It only renders when convertedAmount is not null, isLoading is false, and there is no error. The toFixed(2) method formats the result to two decimal places.
  • Loading Indicator: Displays “Loading…” when isLoading is true.
  • Error Message: Displays an error message if the error state has a value.
  • Basic Styling: Inline styles are used for basic layout and visual appeal. You can move these styles to a separate CSS file for better organization.

Step 5: Handling User Input and Updating State

We’ve already implemented the input fields and dropdowns. Let’s look at how the user input is handled and how it updates the state. We’ve defined the following handler functions:

  • handleFromCurrencyChange(e): This function is triggered when the user selects a different currency in the “From” dropdown. It updates the fromCurrency state with the selected value (e.target.value).
  • handleToCurrencyChange(e): This function is triggered when the user selects a different currency in the “To” dropdown. It updates the toCurrency state with the selected value (e.target.value).
  • handleAmountChange(e): This function is triggered when the user types in the amount input field. It parses the input value to a number. If the input is a valid number, it updates the amount state. If not, it sets the amount to 0.

These event handlers are crucial for making the application interactive. They listen for user actions (changing currency selections, entering an amount), and update the React component’s state accordingly. The updated state then triggers a re-render of the component, updating the UI to reflect the changes.

Step 6: Displaying the Converted Amount

The converted amount is displayed in a paragraph element. The display logic is as follows:


{convertedAmount !== null && !isLoading && !error && (
  <p>{amount} {fromCurrency} = {convertedAmount.toFixed(2)} {toCurrency}</p>
)}

This code ensures the converted amount is only displayed when the following conditions are met:

  • convertedAmount is not null: This ensures that a conversion has been successfully performed.
  • isLoading is false: This prevents the converted amount from being displayed while the API is still fetching data.
  • error is false: This prevents the converted amount from being displayed if there was an error during the API call.

The .toFixed(2) method is used to format the result to two decimal places, making the output cleaner and more user-friendly.

Step 7: Adding Error Handling

Error handling is essential for a robust application. We’ve already included error handling in our API calls. The error state variable stores any error messages. We display the error message in the UI:


{error && <p style={{ color: 'red' }}>Error: {error}</p>}

This code displays an error message in red if the error state is not null. You can expand on this by:

  • Providing more specific error messages: Based on the error type (e.g., “Invalid API key,” “Currency not found”).
  • Logging errors to a server: For monitoring and debugging.
  • Implementing retry mechanisms: For handling temporary network issues.

Step 8: Styling Your Currency Converter (Optional)

While we’ve used inline styles for basic layout, you can create a separate CSS file (e.g., src/App.css) to style your currency converter. This will make your code more organized and easier to maintain. Here’s an example of how you can structure your CSS:


.App {
  font-family: sans-serif;
  text-align: center;
}

.converter-container {
  padding: 20px;
  border: 1px solid #ccc;
  border-radius: 5px;
  max-width: 400px;
  margin: 20px auto;
}

label {
  font-weight: bold;
  margin-right: 10px;
}

input, select {
  padding: 5px;
  border: 1px solid #ccc;
  border-radius: 3px;
  margin-bottom: 10px;
}

.error-message {
  color: red;
}

.loading {
  color: #888;
}

Then, import the CSS file in your App.js or CurrencyConverter.js file:

import './App.css'; // Or import your CSS file in CurrencyConverter.js

And use the CSS classes in your component:


<div className="converter-container">
  <h2>Currency Converter</h2>

  {error && <p className="error-message">Error: {error}</p>}

  {isLoading && <p className="loading">Loading...</p>}

  {/* ... other UI elements ... */}
</div>

Step 9: Testing and Debugging

After building your currency converter, thoroughly test it to ensure it works as expected. Here’s a testing checklist:

  • Currency Selection: Verify that the dropdowns correctly display the currency options and that the selected currencies are reflected in the UI.
  • Amount Input: Test different amounts, including positive numbers, zero, and negative numbers (although negative numbers might not be meaningful in a currency converter). Ensure the input validation works correctly.
  • API Integration: Check that the exchange rates are fetched correctly and that the converted amounts are accurate.
  • Error Handling: Test the error handling by providing an invalid API key or by intentionally causing network errors (e.g., disabling your internet connection). Ensure that error messages are displayed appropriately.
  • Loading Indicator: Verify that the loading indicator is displayed while the API is fetching data.
  • Edge Cases: Try converting from and to the same currency to ensure it handles the scenario correctly.

Use your browser’s developer tools (usually accessed by pressing F12) to debug your application. You can use the “Console” tab to see any error messages or log statements. The “Network” tab allows you to inspect the API requests and responses.

Step 10: Optimizing for Performance

While this is a simple application, you can consider some optimizations for better performance, especially as your application grows:

  • Debouncing Input: If the API has rate limits, you can debounce the handleAmountChange function to reduce the number of API calls when the user types quickly.
  • Caching Exchange Rates: Implement caching to store the exchange rates locally for a certain period. This reduces the number of API calls and improves the user experience, especially if the user is repeatedly converting the same currencies. You can use `localStorage` for simple caching.
  • Code Splitting: For larger applications, you can use code splitting to load only the necessary code for the current view, improving initial load times.
  • Error Boundary: Implement an error boundary to gracefully handle errors that might occur during rendering or in child components.

Common Mistakes and How to Fix Them

Here are some common mistakes and how to fix them:

  • Incorrect API Key: Double-check your API key and ensure it’s correct. Also, verify that the API key is active and hasn’t expired.
  • CORS Errors: If you’re encountering CORS (Cross-Origin Resource Sharing) errors, it means the API server isn’t configured to allow requests from your domain. This is less common with public APIs, but it can happen. You might need to use a proxy server or a different API.
  • Incorrect API Endpoint: Verify that you’re using the correct API endpoint and that the parameters are formatted correctly.
  • State Updates Not Triggering Re-renders: Make sure you’re correctly updating the state using the set... functions (e.g., setAmount, setFromCurrency) provided by the useState hook. Directly modifying the state variables will not trigger a re-render.
  • Unnecessary API Calls: Ensure you’re not making unnecessary API calls. For example, the exchange rate should only be fetched when the currency selections or the amount changes.
  • Forgetting to Handle Loading States: Always handle the loading state to provide a good user experience. Display a loading indicator while fetching data.

Summary / Key Takeaways

Congratulations! You’ve successfully built a functional currency converter in React. You’ve learned how to:

  • Set up a React project using Create React App.
  • Structure your React components.
  • Fetch data from an external API using useEffect and fetch.
  • Manage component state using the useState hook.
  • Build a user interface with input fields, dropdowns, and display elements.
  • Handle user input and update the state.
  • Implement error handling and loading indicators.

This project is a great foundation for building more complex React applications. You can extend it by adding features like historical exchange rates, currency symbols, and a more visually appealing design. Remember to always prioritize user experience and error handling in your applications.

FAQ

Here are some frequently asked questions:

  1. Can I use a different API? Yes, you can use any free or paid API that provides currency exchange rates. Just make sure to adjust the API endpoint and data parsing accordingly.
  2. How can I deploy this application? You can deploy your React application to platforms like Netlify, Vercel, or GitHub Pages.
  3. How do I handle different currencies? The API should provide data for a wide range of currencies. The dropdowns in your UI are populated dynamically from the API response.
  4. How do I add a “swap currencies” button? You can add a button that swaps the values of the fromCurrency and toCurrency states.
  5. How can I store the user’s preferred currency? You can use localStorage to store the user’s preferred currency selection.

As you continue to work with React, remember that practice is key. Building projects like this currency converter is an excellent way to solidify your understanding of React concepts and improve your coding skills. Experiment with different features, explore advanced topics like state management with Context or Redux, and always strive to write clean, maintainable code. The world of front-end development is constantly evolving, so embrace the learning process and enjoy the journey of becoming a proficient React developer. Keep building, keep learning, and keep pushing the boundaries of what you can create. The skills you’ve gained here will serve you well as you tackle more complex and exciting projects in the future, allowing you to create dynamic and engaging web applications that solve real-world problems and provide valuable experiences for users everywhere.

More posts