Skip to content

docs: RFC for SDK hooks approach for partner flexibility#1254

Merged
serikjensen merged 10 commits intomainfrom
rfc/hooks-approach
Apr 14, 2026
Merged

docs: RFC for SDK hooks approach for partner flexibility#1254
serikjensen merged 10 commits intomainfrom
rfc/hooks-approach

Conversation

@serikjensen
Copy link
Copy Markdown
Member

@serikjensen serikjensen commented Mar 13, 2026

Summary

RFC proposing the hooks approach for partner UI flexibility, based on working implementations from PR #1239.

Covers fetch hooks, form hook anatomy, validation messages, form composition, conditional fields, and state taxes. Includes advantages, limitations, and recommendations.

Going to begin working towards implementation, but please review and provide any feedback!

Made with Cursor

@serikjensen serikjensen changed the title docs: RFC for hooks approach to SDK partner flexibility docs: RFC for SDK hooks approach for partner flexibility Mar 16, 2026
@jeffredodd
Copy link
Copy Markdown
Contributor

@serikjensen does this still need to be merged?

Follow-up to the UI flexibility exploration RFC with a concrete
proposal based on working implementations from the SDK-470 branch.

Made-with: Cursor
Bring the RFC up to date with the actual UNSTABLE_Hooks codebase:
- Update status from Draft to Implemented (UNSTABLE)
- Add hook inventory table (7 hooks now shipping)
- Replace generateSchema examples with buildFormSchema pattern
- Document optionalFieldsToRequire partner API
- Replace useEffect+reset with values+resetOptions pattern
- Update return shape to actual nested structure
- Replace per-hook FormProvider with SDKFormProvider
- Add useDeriveFieldsMetadata, useSyncFieldErrors
- Add prebuilt components section
- Add optional entity ID / submit-time resolution pattern
- Update error handling from aspirational to implemented
- Update rollout and recommendations to reflect current state

Made-with: Cursor
@serikjensen serikjensen enabled auto-merge (squash) April 14, 2026 22:16
@serikjensen serikjensen merged commit d91ee71 into main Apr 14, 2026
15 checks passed
@serikjensen serikjensen deleted the rfc/hooks-approach branch April 14, 2026 22:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants