@builder.io/dev-tools

Builder.io Visual CMS Devtools

Setup and integrate Builder.io Visual CMS during development using the Devtools plugin. Builder Devtools can be integrated with a project's development through either a Next.js config, Remix config, Vite plugin, or Webpack plugin.

Installing Builder Devtools

Builder's Devtools can be installed and initialized using:

npm

npm init builder.io@latest

pnpm

pnpm create builder.io@latest

This command will update the config file (such as next.config.js, or vite.config.js) and install the @builder.io/dev-tools package. Once installed, you can start your app's dev server:

npm run dev

Local Development

To develop and test Builder Devtools locally:

• In the devtools directory, build and link the package:

cd dist/dev-tools
npm link

• In your application directory, link to the local devtools:

npm link @builder.io/dev-tools

• You can now run the Figma generate command:

npx builder.io figma generate

Manual Installation

Alternatively, you can manually install Builder's Devtools, and update the config files following the steps below.

npm install -D @builder.io/dev-tools

Next step is to add the Devtools plugin to your build tool's config file. For example, if you're using Next.js, see the docs below on how to import and add Devtools to a Next.js app.

Next.js

A config wrapper function for the Next.js config is provided in order to run Devtools during development. Wrap your existing next config using the withBuilderDevTools() function that's created when it is required at the top of the config file.

// next config file
const withBuilderDevTools = require("@builder.io/dev-tools/next")({
  // Builder Devtools Options
});

module.exports = withBuilderDevTools({
  // next config
});

Or configuration as a function:

module.exports = (phase, defaultConfig) => {
  return withBuilderDevTools(defaultConfig);
};

Remix

A config wrapper function for the Remix config is provided in order to run Devtools during development. Wrap your existing remix config using the withBuilderDevTools() function that's created when it is required at the top of the config file.

// remix config file
const withBuilderDevTools = require("@builder.io/dev-tools/remix")({
  // Builder Devtools Options
});

module.exports = withBuilderDevTools({
  // remix config
});

Vite

The Vite plugin for Devtools is meant for frameworks using Vite for its development. Currently, Devtools supports Qwik integrated with Vite. Import builderDevTools from @builder.io/dev-tools/vite and place it as the the first plugin to ensure it runs before others.

// vite config file
import { defineConfig } from "vite";
import { builderDevTools } from "@builder.io/dev-tools/vite";

export default defineConfig(() => {
  return {
    plugins: [builderDevTools()],
  };
});

Webpack

The Devtools webpack plugin is for React projects. If your project is using Next.js, please see the Next.js docs above on how to add the Devtools plugin to the next config. Below is a general webpack config for a React project.

// webpack config file
const { BuilderDevToolsPlugin } = require("@builder.io/dev-tools/webpack");

module.exports = {
  plugins: [new BuilderDevToolsPlugin()],
};

CLI

Devtools can also be started with a CLI command, which could be useful if there is a custom setup that doesn't fit into one of the above solutions. Below is an example of running CLI from an npm script:

{
  "scripts": {
    "devtools": "builder-dev-tools"
  }
}

Environment Variables

BUILDER_DISABLE_AMPLITUDE

Set BUILDER_DISABLE_AMPLITUDE=true to disable Amplitude analytics tracking when using the devtools CLI. This is useful for privacy-conscious environments or when you want to prevent analytics data collection.

BUILDER_DISABLE_AMPLITUDE=true npx builder.io fusion dev

Or add it to your .env file:

BUILDER_DISABLE_AMPLITUDE=true