Feedback
Configure and manage user feedback collection.
Overview
ZeroStarter includes optional integration for collecting user feedback. When configured, feedback links appear in two locations:
- Docs Sidebar Footer: A feedback link appears in the docs sidebar footer, alongside the app version (
v{version}) - Dashboard User Menu: A feedback option appears in the user dropdown menu in the dashboard sidebar, directly above "Log out"
Both locations allow users to submit feedback and only appear when the feedback URL is configured.
Setup
1. Configure Environment Variable
Add your feedback URL to your .env file:
# Optional: User feedback (https://zerostarter.dev/docs/manage/feedback)
NEXT_PUBLIC_USERJOT_URL=The variable maps to UserJot by default (hence the name), but it accepts any feedback URL: set it to whatever destination you want the links to open.
2. Environment Configuration
The feedback URL is configured in packages/env/src/web-next.ts:
client: {
NEXT_PUBLIC_USERJOT_URL: z.url().optional(),
}The feedback links will automatically appear in both locations when NEXT_PUBLIC_USERJOT_URL is set. If the variable is not set or is empty, the links will not be displayed.
Features
- Docs Sidebar Footer: Feedback link appears in the docs sidebar footer, with
v{version}shown next to it. When feedback is unset, the footer still shows just the version. - Dashboard User Menu: Feedback option appears in the user dropdown menu, directly above "Log out". The user's identity (avatar, name, email) is the dropdown trigger and header; there is no separate user-info menu row between the items.
- Optional: Only loads when
NEXT_PUBLIC_USERJOT_URLis configured - External Link: Opens feedback URL in a new tab
Disabling Feedback
To disable the feedback links, simply remove or leave empty the NEXT_PUBLIC_USERJOT_URL environment variable. The links will not be rendered in either location, ensuring zero performance impact when not in use.