Turn live UI edits into reviewable GitHub pull requests
npm install fixdog> Turn live UI edits into reviewable GitHub pull requests
The easiest way to set up fixdog is using the CLI:
``bash`
npx fixdog init
The CLI will:
- Detect your framework (Vite or Next.js)
- Prompt for your project ID (get it from app.fix.dog)
- Automatically inject the fixdog script into your project
- For Vite projects: Update vite.config.ts/js/mjs to add projectId.fix.dog to allowedHosts
For CI/CD or automation:
`bash`
npx fixdog init --projectId your-project-id --yes
CLI Options:
- --projectId, --project-id, -p - Project ID (non-interactive mode)--yes
- , -y - Skip confirmation prompt--silent
- , -s - Silent mode (no output except errors)--help
- , -h - Show help message
If you prefer to set up manually, see the integration guide or visit fix.dog for detailed documentation.
Add to your index.html inside
:`html
`Also update your
vite.config.ts (or .js/.mjs) to add the project host to allowedHosts:`ts
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";export default defineConfig({
plugins: [react()],
server: {
allowedHosts: ["your-project-id.fix.dog"],
},
});
`$3
Add to your
app/layout.tsx:`tsx
export default function RootLayout({ children }) {
return (
{process.env.NODE_ENV === "development" && (
type="module"
src="https://unpkg.com/fixdog/dist/fixdog.esm.js?projectId=your-project-id"
/>
)}
{children}
);
}
`$3
Add to your
pages/_document.tsx:`tsx
import { Html, Head, Main, NextScript } from "next/document";export default function Document() {
return (
{process.env.NODE_ENV === "development" && (
type="module"
src="https://unpkg.com/fixdog/dist/fixdog.esm.js?projectId=your-project-id"
/>
)}
);
}
`Configuration
$3
| Parameter | Required | Description |
| ----------- | -------- | -------------------------------------------------------------------- |
|
projectId | Yes | Your Fixdog project ID (get from app.fix.dog) |Example:
`
https://unpkg.com/fixdog/dist/fixdog.esm.js?projectId=my-project
`For more configuration options and API details, visit fix.dog.
Troubleshooting
- Source not available: Ensure dev/build has
_debugSource` (development or React Refresh). Production builds often strip it.- React 16.8+ through React 19
- Works with Next.js (App Router and Pages Router) and Vite
- Only runs in development mode by default
Visit app.fix.dog to create a project and get your project ID.
For detailed documentation, examples, and advanced usage, visit fix.dog.