ARTICLE

Dashboard Quick Start: Your First Feedback

Sign in, create a project, paste one script tag, and read the first piece of feedback.

Qaid Team
TL;DR

Sign in with GitHub, Google or an emailed link, then create a project. Its empty inbox shows a script tag with your key already in it: paste it before </body>. Reload the inbox after you click a thumb and the feedback is there.

This page takes you from a new account to the first piece of feedback in your inbox. The rest of the dashboard has its own guides, linked at the end.

Sign in

Open qaid.dev/login. Pick Continue with GitHub, Continue with Google, or type your email and press Send Magic Link. There is no password. The first sign-in makes your account and opens the Command Center, your home page.

Create your first project

A project is one site you collect feedback for. It holds its own key, inbox and settings.

  1. Open the projects page

    Click Projects in the left rail. You can also use + New project on the Projects panel of your home page.

  2. Start a new project

    Click New Project.

  3. Name it

    Fill in Project Name. It is the only field you must fill.

  4. Add a domain if you want one

    Domain (optional) takes a bare host such as example.com. With a domain set, the project only accepts feedback from that host and its subdomains. localhost always works, so you can test on your own machine.

  5. Create it

    Click Create Project. The new project’s inbox opens.

Loading the film…

Qaid makes an API key named “Default” for the project. The Free plan allows one project and one key. See Free vs Pro for the other limits.

Copy your install snippet and check it

A project with no feedback yet shows Install the embed where the list will be. The snippet under it already carries your key and the endpoint.

  1. Copy the snippet

    Click Copy on the snippet.

  2. Paste it into your site

    Put it just before </body> on every page that should show the buttons.

  3. Check the install

    Click Check Installation. Qaid loads your domain’s home page and looks for the script and your key. You get “Embed is correctly installed!”, “Embed found but using a different API key”, or “Could not find the Qaid embed script on the page”.

Loading the film…

Without a domain, the button reads Add Domain First and opens the project settings. The check only reads the home page, so an embed that is only on other pages, or one added by your build tools, can fail the check and still work.

Install the embed

The snippet from the inbox is a plain script tag:

<script
  src="https://unpkg.com/@qaiddev/thumbs-embed/dist/embed.js"
  defer
  data-api-key="your-api-key-here"
  data-endpoint="https://qaid.dev/api/feedback"
></script>

If your site has a build step, install the package instead:

npm install @qaiddev/thumbs-embed

import { QaidFeedback } from '@qaiddev/thumbs-embed';

new QaidFeedback({
  endpoint: 'https://qaid.dev/api/feedback',
  apiKey: 'your-api-key-here',
});

The buttons sit in the bottom-right corner unless you move them:

Loading the live demo…

Watch your first feedback arrive

Click a thumb on your site and send the form. Then reload the project page. The inbox does not refresh by itself.

Loading the film…

Each row shows the thumb, the message and the date. A cyan dot means you have not opened it yet. Click the row to see the whole record: the page, the element the visitor picked, and anything they attached.

Pro

Screenshots, console errors and screen recordings need Pro. On Free the feedback still arrives without them, up to 100 items a month per project. See Free vs Pro.

Where to go next

  1. Triage the inbox: filters, batch actions and notes.
  2. Arrange your command center: the panels on your home page.
  3. Invite your team and choose your emails.
  4. Match the buttons to your brand.
Back to all articles