migrate-frontend-forms
Form Migration Guide
This skill helps migrate forms from Sentry's legacy form system (JsonForm, FormModel) to the new TanStack-based system.
Feature Mapping
| Old System | New System | Notes |
|---|---|---|
saveOnBlur: true |
AutoSaveForm |
Default behavior |
confirm |
confirm prop |
string | ((value) => string | undefined) |
showHelpInTooltip |
variant="compact" |
On layout components |
disabledReason |
disabled="reason" |
String shows tooltip |
extraHelp |
JSX in layout | Render <Text> below field |
getData |
mutationFn |
Transform data in mutation function |
mapFormErrors |
setFieldErrors |
Transform API errors in catch block |
saveMessage |
onSuccess |
Show toast in mutation onSuccess callback |
formatMessageValue |
onSuccess |
Control toast content in onSuccess callback |
resetOnError |
onError |
Call form.reset() in mutation onError |
saveOnBlur: false |
useScrapsForm |
Use regular form with explicit Save button |
More from getsentry/sentry
design-system
Guide for using Sentry's layout and text primitives. Use when implementing UI components, layouts, or typography. Enforces use of core components over styled components.
84sentry-security
Sentry-specific security review based on real vulnerability history. Use when reviewing Sentry endpoints, serializers, or views for security issues. Trigger keywords: "sentry security review", "check for IDOR", "access control review", "org scoping", "cross-org", "security audit endpoint".
67generate-migration
Generate Django database migrations for Sentry. Use when creating migrations, adding/removing columns or tables, adding indexes, or resolving migration conflicts.
67sentry-javascript-bugs
Review Sentry React and TypeScript changes for bug patterns drawn from real production issues. Use when reviewing a frontend diff or PR, checking Warden findings, auditing the current branch, reviewing production-error patterns, or looking for common regressions in `static/`.
61generate-frontend-forms
Guide for creating forms using Sentry's new form system. Use when implementing forms, form fields, validation, or auto-save functionality.
61sentry-backend-bugs
Review Sentry Python and Django changes for bug patterns drawn from real production issues. Use when reviewing a backend diff or PR, checking Warden findings, auditing the current branch, reviewing production-error patterns, or looking for common regressions in `src/` and `tests/`.
55