Skip to content

Add docs feedback widget#3142

Draft
pwizla wants to merge 34 commits intonextfrom
repo/add-feedback-widget
Draft

Add docs feedback widget#3142
pwizla wants to merge 34 commits intonextfrom
repo/add-feedback-widget

Conversation

@pwizla
Copy link
Copy Markdown
Collaborator

@pwizla pwizla commented May 7, 2026

This PR adds a 3-level feedback widget to all doc pages:

  • L1: Thumbs up/down with optional/required comment form
  • L2: Text selection feedback via floating bubble
  • L3: GitHub issue creation link for negative feedback with pre-filled template
  • Backend: n8n webhook at n8n.tools.strapi.team writing to Notion database (replaces initial Vercel Functions approach)
  • Anti-spam: origin check, custom header, honeypot, payload validation
  • Includes n8n workflow JSON files for reference/re-import
  • Dark mode, mobile responsive, no console errors

pwizla and others added 30 commits May 6, 2026 15:56
Remove Vercel serverless backend (api/ directory, @notionhq/client,
CORS headers in vercel.json). Frontend now sends feedback directly
to n8n webhook at n8n.tools.strapi.team/webhook/docs-feedback.

Add n8n workflow JSON files for import:
- docs-feedback-webhook.json: main workflow (validate, anti-spam, write to Notion)
- docs-feedback-spam-alert.json: cron workflow (>100/min Slack alert)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@pwizla pwizla requested a review from derrickmehaffy as a code owner May 7, 2026 15:26
@vercel
Copy link
Copy Markdown

vercel Bot commented May 7, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
documentation Ready Ready Preview, Comment May 7, 2026 4:53pm

Request Review

@github-actions github-actions Bot added the internal PRs created by the Strapi core team label May 7, 2026
The _hp hidden field existed in the form but its value was never
passed to submitFeedback. Now FeedbackForm reads the field on
submit and forwards it so the n8n anti-spam check can detect bots.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
100 feedbacks/hour threshold is sufficient for docs.strapi.io.
Running every minute was overkill and wasted Notion API calls.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
These are reference files for n8n import, not used by the code.
The workflows are configured directly in n8n.tools.strapi.team.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Set FEEDBACK_ENABLED to false in config.js to disable the widget.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@pwizla pwizla changed the title Add docs feedback widget with n8n backend Add docs feedback widget May 7, 2026
@pwizla pwizla marked this pull request as draft May 7, 2026 16:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal PRs created by the Strapi core team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant