Before you start
- A Feddy project and its project ID. You’ll find the ID under Settings → Install in the dashboard. No project yet? Create one first.
- Nothing to install from npm. The widget is one script loaded from Feddy’s servers.
1
Add two lines to your layout
Astro normally rewrites Put them just before the closing
<script> tags as part of its build. is:inline tells it to leave these two alone, so the widget loads exactly as written:src/layouts/Layout.astro
</body> tag of the layout every page uses.The project ID isn’t a secret. It’s visible in your page source, so anyone can find it, and that’s fine: it only tells Feddy which inbox a message belongs to. Commit it like any other setting. There’s nothing to protect, so keep it out of your secrets file.
2
Choose how users open it
By default, a floating chat button appears in the bottom-right corner. If you’d rather open Feddy from your own button, pass
launcher: false to init and call Feddy.open() when the button is clicked.If your site uses Astro’s <ClientRouter /> for page transitions, the widget stays in place as users move between pages.3
Send yourself a message
Open the page, click the button, and send a message. Then open your inbox at dash.feddy.app: it’s there, with the page URL and browser alongside.Reply from the inbox. Back on the page, the reply appears in the panel.
That’s the whole loop: a visitor writes in, you answer, and the answer reaches them on your site.
Next steps
Identify users
Tell Feddy who’s logged in, so you see their name in the inbox and replies can reach them by email.
Unread badge
Show the count on your own element when you’ve turned the floating button off.
Conversations
What you’re looking at in the inbox, and what happens on its own.
Web SDK reference
Every option and call in the widget.