Bolt.new AI and Nexmo (Vonage API) integration: Step-by-Step Guide 2025

 

Setting Up Dependencies in Your Project

 

• Create or open your existing package.json file in your Bolt.new AI project.
• Add the nexmo dependency manually by inserting it into the "dependencies" section. Since Bolt.new AI doesn’t provide a terminal, you must edit this file directly. For example, update your package.json like this:

  
  {
    "name": "my-bolt-project",
    "version": "1.0.0",
    "dependencies": {
      "nexmo": "^2.9.2"
    },
    "scripts": {
      "start": "node dist/index.js"
    }
  }
      

 

Creating the Nexmo Integration File

 

• Inside your project’s source folder (commonly named src), create a new file called nexmoIntegration.ts.
• Insert the following TypeScript code into nexmoIntegration.ts. This code initializes the Nexmo client using API credentials from environment variables and provides a function to send an SMS:

  
  import Nexmo from 'nexmo';
  
  const nexmo = new Nexmo({
    apiKey: process.env.NEXMOAPIKEY as string,
    apiSecret: process.env.NEXMOAPISECRET as string,
  });
  export function sendSMS(from: string, to: string, text: string): void {
    nexmo.message.sendSms(from, to, text, (error, responseData) => {
      if (error) {
        console.error("Error occurred:", error);
      } else {
        const message = responseData.messages[0];
        if (message.status === "0") {
          console.log("Message sent successfully.");
        } else {
          console.error(Message failed with error: ${message['error-text']});
        }
      }
    });
  }
      

  
  


• Make sure that your API keys are stored in environment variables. In Bolt.new AI, you typically set these in your project’s settings or secrets configuration with keys NEXMOAPIKEY and NEXMOAPISECRET.

 

Integrating Nexmo Functionality in Your Main Application

 

• Open your main TypeScript file (for example, index.ts or app.ts) in the src folder.
• Import the sendSMS function from nexmoIntegration.ts at the top of your file, and call it in the context of your application logic. For instance, you might add an endpoint that triggers an SMS send:

  
  import express from 'express';
  import { sendSMS } from './nexmoIntegration';
  
  const app = express();
  // Example endpoint to send an SMS
  app.get('/send-sms', (req, res) => {
    const from = 'YourApp';
    const to = 'RecipientPhoneNumber'; // Replace with a valid phone number
    const text = 'Hello from Bolt.new AI integrated with Nexmo!';
    sendSMS(from, to, text);
    res.send('SMS send initiated. Check your console for the response.');
  });
  // Start the server on the designated port
  const PORT = process.env.PORT || 3000;
  app.listen(PORT, () => {
    console.log(Server is running on port ${PORT});
  });
      

  
  


• This code snippet sets up a basic Express server with an endpoint /send-sms that uses the Nexmo integration to send an SMS message.

 

Finalizing Environment Variables and Deployment

 

• Go to your Bolt.new AI project settings and locate the area where environment variables or secrets are configured.
• Add the following keys:
  • NEXMOAPIKEY: Your Nexmo API key
  • NEXMOAPISECRET: Your Nexmo API secret
• Ensure that your main file (e.g., index.ts) and the Nexmo integration file are saved. Bolt.new AI will automatically compile your TypeScript files and deploy the application.
• Click the Run or Deploy button in the Bolt.new AI interface to start your application.

 

By following these steps, you have manually added the nexmo dependency, created a dedicated integration file, and incorporated the SMS sending functionality into your Bolt.new AI project without using a terminal.