Bolt.new AI and Freightos integration: Step-by-Step Guide 2025

Book a call with an Expert

Starting a new venture? Need to upgrade your web app? RapidDev builds application with your growth in mind.

How to integrate Bolt.new AI with Freightos?

Creating the Freightos Integration File

Create a new file in your Bolt.new AI project named freightos.ts in the root directory.
This file will contain the integration logic that communicates with Freightos via their API.
Copy and paste the following code snippet into freightos.ts:


export async function getFreightRates(origin: string, destination: string, cargoDetails: any): Promise {
  // Retrieve your Freightos API key from environment variables.
  // Make sure to add FREIGHTOSAPIKEY to your project's secrets settings.
  const apiKey = process.env.FREIGHTOSAPIKEY;
  if (!apiKey) {
    throw new Error("Freightos API key is not configured.");
  }
  
  // Replace the URL below with the actual Freightos API endpoint if different.
  const apiUrl = "https://api.freightos.com/v1/rates";

  // Build the request payload using provided parameters.
  const payload = {
    origin,
    destination,
    cargo: cargoDetails
  };

  // Perform a POST request to Freightos API.
  const response = await fetch(apiUrl, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": Bearer ${apiKey}
    },
    body: JSON.stringify(payload)
  });

  if (!response.ok) {
    const errorText = await response.text();
    throw new Error("Failed to fetch freight rates: " + errorText);
  }

  return await response.json();
}

Configuring Environment Variables for Freightos

Since Bolt.new AI does not provide a terminal, configure your environment variables using the platform’s secret management interface.
Add a new secret with the key FREIGHTOSAPIKEY and set its value to your Freightos API key.
This secret will be accessed in your code via process.env.FREIGHTOSAPIKEY.

Using the Freightos Integration in Your Main Code

Open your main TypeScript file (commonly index.ts or similar).
Import the getFreightRates function from the newly created freightos.ts file.
Use the function within your code logic to call the Freightos API when needed. For example, you may call it as part of an API endpoint or event handler.
Insert the following code snippet into your main file where you wish to integrate the Freightos functionality:


import { getFreightRates } from "./freightos";

// Example function that could be triggered by a user action or API request.
async function handleGetFreightRates() {
  try {
    // Example parameters. Replace with actual data as required.
    const origin = "NYC";
    const destination = "LAX";
    const cargoDetails = {
      weight: 1000,  // weight in lbs or kg based on your requirements
      dimensions: { length: 10, width: 5, height: 4 }
    };

    const rates = await getFreightRates(origin, destination, cargoDetails);
    console.log("Freight rates:", rates);
    // Handle the rates data (e.g., update UI, forward to another service, etc.)
  } catch (error) {
    console.error("Error retrieving freight rates:", error);
  }
}

// For demonstration, call the function immediately.
// In your application, integrate this call with your event logic.
handleGetFreightRates();

Integrating Fetch Polyfill (if required)

By default, Bolt.new AI supports TypeScript and most runtime environments include a built-in fetch function. If you encounter issues with fetch, consider adding a polyfill.
Since Bolt.new AI does not allow terminal access for dependency installation, include a CDN link to a fetch polyfill in your project if needed (for example, by using a script tag in your HTML if applicable).
If your project framework permits, simply add the following snippet to your main HTML file within the <head> section:


<script src="https://cdnjs.cloudflare.com/ajax/libs/whatwg-fetch/3.6.2/fetch.umd.js"></script>

Finalizing the Integration

Ensure that you have saved all changes in your project.
Test the Freightos integration by triggering the handleGetFreightRates function in your application.
Use the Bolt.new AI interface’s logs or console output to verify that the API call is working correctly and that Freightos is returning the expected data.

Rapid Dev was an exceptional project management organization and the best development collaborators I've had the pleasure of working with. They do complex work on extremely fast timelines and effectively manage the testing and pre-launch process to deliver the best possible product. I'm extremely impressed with their execution ability.

CPO, Praction - Arkady Sokolov

May 2, 2023

Working with Matt was comparable to having another co-founder on the team, but without the commitment or cost. He has a strategic mindset and willing to change the scope of the project in real time based on the needs of the client. A true strategic thought partner!

Co-Founder, Arc - Donald Muir

Dec 27, 2022

Rapid Dev are 10/10, excellent communicators - the best I've ever encountered in the tech dev space. They always go the extra mile, they genuinely care, they respond quickly, they're flexible, adaptable and their enthusiasm is amazing.

Co-CEO, Grantify - Mat Westergreen-Thorne

Oct 15, 2022

Rapid Dev is an excellent developer for no-code and low-code solutions.
We’ve had great success since launching the platform in November 2023. In a few months, we’ve gained over 1,000 new active users. We’ve also secured several dozen bookings on the platform and seen about 70% new user month-over-month growth since the launch.

Co-Founder, Church Real Estate Marketplace - Emmanuel Brown

May 1, 2024

Matt’s dedication to executing our vision and his commitment to the project deadline were impressive.
This was such a specific project, and Matt really delivered. We worked with a really fast turnaround, and he always delivered. The site was a perfect prop for us!

Production Manager, Media Production Company - Samantha Fekete

Sep 23, 2022