[v2] Allow nesting of field groups
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 6.7k
- Forks
- 682
- Avg merge
- 5d 18h
- Merged PRs (30d)
- 7
Description
Describe the bug
In v2, a field group cannot be composed inside another field group.
The parent only exposes fields, but the child requires a form prop. Passing form={fields} causes a TypeScript error. In v1, this worked with form={group}.
Your minimal, reproducible example
N/A - this is a question about the core
Steps to reproduce
- Create a child field group with
defineFieldGroup. - Render it inside another field group.
- Pass the parent fields using
form={fields}. - TypeScript reports incompatible types.
Expected behavior
Nested field groups should be composable
How often does this bug happen?
None
Screenshots or Videos
No response
Platform
N/A
TanStack Form adapter
None
TanStack Form version
v2.0.0-alpha.2
TypeScript version
No response
Additional context
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by tracing the v2 core types behind defineFieldGroup, especially how parent fields and the child form prop are typed. Reproduce the nested-group example in a TypeScript check, then confirm that a child field group can accept the parent fields without a type error and that existing field-group behavior remains intact.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- frontend
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100