@dyad-sh/react-vite-component-tagger v0.8.0
@dyad-sh/react-vite-component-tagger
A Vite plugin that automatically adds data-dyad-id
and data-dyad-name
attributes to your React components. This is useful for identifying components in the DOM, for example for testing or analytics.
Installation
npm install @dyad-sh/react-vite-component-tagger
# or
yarn add @dyad-sh/react-vite-component-tagger
# or
pnpm add @dyad-sh/react-vite-component-tagger
Usage
Add the plugin to your vite.config.ts
file:
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";
import dyadTagger from "@dyad-sh/react-vite-component-tagger";
// https://vitejs.dev/config/
export default defineConfig({
plugins: [react(), dyadTagger()],
});
The plugin will automatically add data-dyad-id
and data-dyad-name
to all your React components.
The data-dyad-id
will be a unique identifier for each component instance, in the format path/to/file.tsx:line:column
.
The data-dyad-name
will be the name of the component.
Testing & Publishing
Bump it to an alpha version and test in Dyad app, eg. "version": "0.0.1-alpha.0",
Then publish it:
cd packages/@dyad-sh/react-vite-component-tagger/ && npm run prepublishOnly && npm publish
Update the scaffold like this:
cd scaffold && pnpm remove @dyad-sh/react-vite-component-tagger && pnpm add -D @dyad-sh/react-vite-component-tagger
Run the E2E tests and make sure it passes.
Then, bump to a normal version, e.g. "0.1.0" and then re-publish. We'll try to match the main Dyad app version where possible.