Troubleshooting
React package install returns 401 or 404
Section titled “React package install returns 401 or 404”The React package is hosted on GitHub Packages, not currently on npmjs. Configure the @social-pulse-crm registry and provide a GitHub token with read:packages through an environment variable. Do not commit the token. Cloudflare Pages hosting the documentation does not make npm packages public.
Widget does not appear
Section titled “Widget does not appear”- Confirm
BugFence.init()ran in the browser andprojectKeyis the public project key. - Set
endpointto the production API URL; the default points to localhost. - Check the browser network panel for the core SDK script and report endpoint.
- If the launcher is hidden, check route exclusions and
showLauncher.
Add-on does not load
Section titled “Add-on does not load”Check that the configured endpoint origin serves the corresponding /sdk/bugfence-*.min.js asset and that CSP allows its script origin. false disables the feature; omit the option to use the registered add-on or default on-demand loading.
Cloudflare says Cannot find cwd: .../docs-site
Section titled “Cloudflare says Cannot find cwd: .../docs-site”Cloudflare is trying to build a root directory that is absent from the Git revision it cloned. Ensure docs-site/ is committed and pushed to the selected production branch. Configure Pages with root docs-site, build command npm run build, and output dist; do not use the Worker wrangler deploy flow for this site.
Review privacy before sending
Section titled “Review privacy before sending”Client-side masking is best-effort. Review captured evidence and use explicit mask/block selectors for sensitive content. Never put secret or admin credentials in browser code.