IsharaBeta
Install guides (31)

Add Ishara to Astro

Add the feedback widget to an Astro site with one script tag, marked is:inline, before the closing body tag of your shared layout.

Where it goes
Your shared layout, before </body>
Allowed domains
Your own domain (set when you add the site)
Time
About 2 minutes

Steps

  1. In Ishara, open Sites → your site → Install and copy the line under Add the line to your site. Your site’s key is already in it:

    HTML
    <script src="https://useishara.com/w.js" data-site="pk_…" defer></script>
  2. Open the layout your pages share, such as src/layouts/Layout.astro, and paste the line just before </body>, adding is:inline so Astro leaves it exactly as written:

    src/layouts/Layout.astro
    <html lang="en">
      <head>
        <meta charset="utf-8" />
        <title>My site</title>
      </head>
      <body>
        <slot />
        <script is:inline src="https://useishara.com/w.js" data-site="pk_…" defer></script>
      </body>
    </html>
  3. Build and deploy the site.

  4. Open your site. Back on the Install page, Check it’s live turns into The widget is live as soon as the widget loads. Then open the Reviewer link from the same page: only people who open it see Leave a note.

Good to know

  • Pages that don’t use this layout don’t get the widget. If you have several layouts, add the line to each, or to one they all share.
  • Don’t load the widget from a framework component’s useEffect or onMount: that only runs once the island hydrates, and only on pages that include it.
  • Astro adds no Content Security Policy of its own. If your host sends one, allow the widget’s origin in script-src (details).

Next

Once reviewers leave notes, your coding agent can apply them. The widget’s options (language, position, colour, launcher) are in the docs.