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

 

Step 1: Adding the Harvest Integration File

 

• Create a new file in your Bolt.new AI project called harvestIntegration.ts. This file will contain all the TypeScript code required to interact with the Harvest API.
• Paste the following code into harvestIntegration.ts. This code defines a HarvestClient class that you can use to perform API calls to Harvest. The example includes a method to fetch details of the current user.

export class HarvestClient {
  private token: string;
  private accountId: string;
  private baseUrl: string = 'https://api.harvestapp.com/v2';

  constructor(token: string, accountId: string) {
    this.token = token;
    this.accountId = accountId;
  }

  public async getCurrentUser() {
    const url = ${this.baseUrl}/users/me;
    const response = await fetch(url, {
      headers: {
        'Authorization': Bearer ${this.token},
        'Harvest-Account-Id': this.accountId,
        'User-Agent': 'Bolt.new-AI-Integration'
      }
    });
    if (!response.ok) {
      throw new Error(Error fetching data: ${response.status} ${response.statusText});
    }
    return response.json();
  }
}

 

Step 2: Modifying the Main Project File

 

• Open the main file of your Bolt.new AI project (for example, main.ts).
• At the top of the file, import the HarvestClient from the file you just created.
• Initialize the HarvestClient with your Harvest API token and account ID. Replace YOURHARVESTTOKEN and YOURHARVESTACCOUNT_ID with your actual credentials.
• Insert a function call to fetch and log the current user's data from Harvest. This code will help you verify that your integration works properly.

import { HarvestClient } from './harvestIntegration';

const token = 'YOURHARVESTTOKEN';         // Replace with your Harvest API token
const accountId = 'YOURHARVESTACCOUNT_ID'; // Replace with your Harvest Account ID

const harvest = new HarvestClient(token, accountId);

harvest.getCurrentUser()
  .then(userData => {
    console.log('Current Harvest user:', userData);
  })
  .catch(error => {
    console.error('Harvest API error:', error);
  });

 

Step 3: Managing Dependencies Without a Terminal

 

• Since Bolt.new AI does not include a terminal, you cannot run commands to install new packages. Instead, rely on the browser's built-in fetch API to perform HTTP requests, as shown in the code above.
• If you require additional libraries in the future, add them directly to your project’s files. For example, if you need a specific utility, you can copy its code into a new file and import it accordingly.

 

Step 4: Testing the Integration

 

• Save all changes to your project files.
• Run your Bolt.new AI project. The console should display the data of the current Harvest user if the API call is successful.
• If an error occurs, check the console messages to debug the issue. Ensure that your API token and account ID values are correct.

 

Step 5: Customizing for Your Needs

 

• You can expand the HarvestClient class in harvestIntegration.ts to support additional endpoints from the Harvest API. For example, methods to fetch project lists, time entries, and more can be added.
• Whenever you wish to make another API call, simply create a new method inside HarvestClient following the same structure as getCurrentUser().
• Include any necessary error handling or data formatting within these new methods to suit your application’s requirements.