Manual installation
Integrate Weave.js to a new or existing Next.js project
In this guide, we will manually integrate Weave.js into a Next.js application.
Why Next.js?
Prerequisites
Before you begin, ensure that you meet the requirements.
Next.js version used
Weave.js is not compatible with React 19, which is included in Next.js 15. For this reason, we will use Next.js 14.
Step by step
Set up your project
To have a Weave.js project running, follow these steps:
Install Next.js
If you don't have a Next.js 14 project already, start by creating a new one. Run the following command, and when prompted, accept all the default values:
npx create-next-app@next-14
When finished, navigate to the project folder and start the development server by running the following command:
npm run dev
You should be able now to open your Next.js base app on a browser by navigating to http://localhost:3000
.
Failed to load images
Some images in the default Next.js template may not load correctly. You can safely ignore this issue since it is specific to the template and does not impact the functionality of Weave.js.
Install Weave.js SDK
Located on your root project folder, install the Weave.js SDK by executing the following command:
npm install @inditextech/weave-sdk
Set up the backend
Follow the steps to set up the backend of the application.
Set up the frontend
Follow the steps to set up the frontend of the application.
Run the project
If you have completed all the previous steps, you should have a working project.
To run the project, use the following command:
npm run dev
On a browser navigate to http://localhost:3000
.
You will see the Enter Room page:

On it, enter a room name and your username, then click on the ENTER THE ROOM button.
Once the Room loads, you will be able to:

- View the collaborative canvas.
- Zoom and pan the canvas.
- Create a simple node, such as a Rectangle.
Next, try opening another tab with a different username and the same room name and make some changes. In the first tab, you should see the changes made by this new user.
Congratulations! You have a working Weave.js application.
Next steps
Now that you've completed the quickstart, you're ready to dive deeper into Weave.js and unlock its full potential. Here are some of our recommended next steps:
Explore the building blocks
To learn how to build modular and interactive tools, explore how Weave.js is structured under the hood and get familiar with core concepts like:
Review the API Reference
Dive into API reference to explore all available methods, utilities, and configuration options. This is your go-to resource as you start building more advanced features.