Skip to main content

Feedback widget for Fumadocs

PushFeedback collects user feedback directly from your website. This guide covers installation in a Fumadocs project.

Feedback widget for docs screenshot

Prerequisites​

Before you begin, you need:

  • A PushFeedback account. If you don't have one, sign up for free.
  • A project created in your PushFeedback dashboard. If you haven't created one yet, follow the steps in the Quickstart guide.
  • A Fumadocs site and Node.js installed.

Installation​

  1. Install PushFeedback:

    npm install pushfeedback-react
    info

    If you're using pnpm as your package manager, run pnpm add pushfeedback-react instead of the npm command above.

  2. Create a new component file components/feedback-widget.tsx with the following content:

    'use client';

    import React, { useEffect } from 'react';
    import { FeedbackButton } from 'pushfeedback-react';
    import { defineCustomElements } from 'pushfeedback/loader';
    import 'pushfeedback/dist/pushfeedback/pushfeedback.css';

    export function FeedbackWidget() {
        useEffect(() => {
            if (typeof window !== 'undefined') {
                defineCustomElements(window);
            }
        }, []);

        return (
            <FeedbackButton 
                project="<YOUR_PROJECT_ID>" 
                button-position="bottom-right" 
                modal-position="bottom-right" 
                button-style="dark"
                custom-font="true">
                Feedback
            </FeedbackButton>
        );
    }

    Replace <YOUR_PROJECT_ID> with your project's ID from the PushFeedback dashboard.

  3. Import and add the FeedbackWidget component to your root layout file (app/layout.tsx):

    import { FeedbackWidget } from '@/components/feedback-widget';

    export default function RootLayout({
      children,
    }: {
      children: React.ReactNode;
    }) {
      return (
        <html lang="en">
          <body>
            {children}
            <FeedbackWidget />
          </body>
        </html>
      );
    }

  4. Start your Fumadocs project by running npm run dev in your terminal. Once it compiles successfully, verify that the feedback button appears and functions correctly on your site.

Next steps​

Choose what to do next:

  • Customization — Adjust the widget's layout, styles, and text.
  • Integrations — Forward feedback to Slack, email, Jira, and more.