Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
React composition patterns for scalable component architecture. Use when refactoring components with boolean prop proliferation, building flexible component libraries, designing reusable component APIs, or working with compound components and context providers.
React composition patterns for scalable component architecture. Use when refactoring components with boolean prop proliferation, building flexible component libraries, designing reusable component APIs, or working with compound components and context providers.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Composition patterns for building flexible, maintainable React components. Avoid boolean prop proliferation by using compound components, lifting state, and composing internals. These patterns make codebases easier to work with as they scale.
Refactoring components with many boolean props Building reusable component libraries Designing flexible component APIs Working with compound components or context providers
#PatternImpact1Avoid Boolean PropsCRITICAL2Compound ComponentsHIGH3Context Interface (DI)HIGH4State LiftingHIGH5Explicit VariantsMEDIUM6Children Over Render PropsMEDIUM
npx clawhub@latest install react-composition
Don't add boolean props like isThread, isEditing, isDMThread to customize behavior. Each boolean doubles possible states and creates unmaintainable conditional logic. Use composition instead. // BAD โ boolean props create exponential complexity function Composer({ isThread, isDMThread, isEditing, isForwarding }: Props) { return ( <form> <Input /> {isDMThread ? <AlsoSendToDMField /> : isThread ? <AlsoSendToChannelField /> : null} {isEditing ? <EditActions /> : isForwarding ? <ForwardActions /> : <DefaultActions />} </form> ) } // GOOD โ composition eliminates conditionals function ChannelComposer() { return ( <Composer.Frame> <Composer.Input /> <Composer.Footer><Composer.Attachments /><Composer.Submit /></Composer.Footer> </Composer.Frame> ) } function ThreadComposer({ channelId }: { channelId: string }) { return ( <Composer.Frame> <Composer.Input /> <AlsoSendToChannelField id={channelId} /> <Composer.Footer><Composer.Submit /></Composer.Footer> </Composer.Frame> ) } Each variant is explicit about what it renders. Shared internals without a monolithic parent.
Structure complex components with shared context. Each subcomponent accesses state via context, not props. Export as a namespace object. const ComposerContext = createContext<ComposerContextValue | null>(null) function ComposerProvider({ children, state, actions, meta }: ProviderProps) { return <ComposerContext value={{ state, actions, meta }}>{children}</ComposerContext> } function ComposerInput() { const { state, actions: { update }, meta: { inputRef } } = use(ComposerContext) return <TextInput ref={inputRef} value={state.input} onChangeText={(t) => update((s) => ({ ...s, input: t }))} /> } const Composer = { Provider: ComposerProvider, Frame: ComposerFrame, Input: ComposerInput, Submit: ComposerSubmit, Footer: ComposerFooter, } // Consumers compose exactly what they need <Composer.Provider state={state} actions={actions} meta={meta}> <Composer.Frame> <Composer.Input /> <Composer.Footer><Composer.Formatting /><Composer.Submit /></Composer.Footer> </Composer.Frame> </Composer.Provider>
Define a generic interface with state, actions, and meta. Any provider implements this contract โ enabling the same UI to work with different state implementations. The provider is the only place that knows how state is managed. interface ComposerContextValue { state: { input: string; attachments: Attachment[]; isSubmitting: boolean } actions: { update: (fn: (s: ComposerState) => ComposerState) => void; submit: () => void } meta: { inputRef: React.RefObject<TextInput> } } // Provider A: Local state for ephemeral forms function ForwardMessageProvider({ children }: { children: React.ReactNode }) { const [state, setState] = useState(initialState) return ( <ComposerContext value={{ state, actions: { update: setState, submit: useForwardMessage() }, meta: { inputRef: useRef(null) } }}>{children}</ComposerContext> ) } // Provider B: Global synced state for channels function ChannelProvider({ channelId, children }: Props) { const { state, update, submit } = useGlobalChannel(channelId) return ( <ComposerContext value={{ state, actions: { update, submit }, meta: { inputRef: useRef(null) } }}>{children}</ComposerContext> ) } Swap the provider, keep the UI. Same Composer.Input works with both.
Move state into dedicated provider components so sibling components outside the main UI can access and modify state without prop drilling or refs. // BAD โ state trapped inside component; siblings can't access it function ForwardMessageComposer() { const [state, setState] = useState(initialState) return <Composer.Frame><Composer.Input /><Composer.Footer /></Composer.Frame> } function ForwardMessageDialog() { return ( <Dialog> <ForwardMessageComposer /> <MessagePreview /> {/* Can't access composer state */} <ForwardButton /> {/* Can't call submit */} </Dialog> ) } // GOOD โ state lifted to provider; any descendant can access it function ForwardMessageProvider({ children }: { children: React.ReactNode }) { const [state, setState] = useState(initialState) const submit = useForwardMessage() return ( <Composer.Provider state={state} actions={{ update: setState, submit }} meta={{ inputRef: useRef(null) }}>{children}</Composer.Provider> ) } function ForwardMessageDialog() { return ( <ForwardMessageProvider> <Dialog> <ForwardMessageComposer /> <MessagePreview /> {/* Reads state from context */} <ForwardButton /> {/* Calls submit from context */} </Dialog> </ForwardMessageProvider> ) } function ForwardButton() { const { actions } = use(Composer.Context) return <Button onPress={actions.submit}>Forward</Button> } Key insight: Components that need shared state don't have to be visually nested โ they just need to be within the same provider.
Instead of one component with many boolean props, create explicit variants. Each composes the pieces it needs โ self-documenting, no impossible states. // BAD โ what does this render? <Composer isThread isEditing={false} channelId="abc" showAttachments showFormatting={false} /> // GOOD โ immediately clear <ThreadComposer channelId="abc" /> <EditMessageComposer messageId="xyz" /> <ForwardMessageComposer messageId="123" /> Each variant is explicit about its provider/state, UI elements, and actions.
Use children for composition instead of renderX props. Children are more readable and compose naturally. // BAD โ render props <Composer renderHeader={() => <CustomHeader />} renderFooter={() => <><Formatting /><Emojis /></>} /> // GOOD โ children composition <Composer.Frame> <CustomHeader /> <Composer.Input /> <Composer.Footer><Composer.Formatting /><SubmitButton /></Composer.Footer> </Composer.Frame> When render props are appropriate: When the parent needs to pass data back (e.g., renderItem={({ item, index }) => ...}).
Component has 3+ boolean props? โ Extract explicit variants (1, 5) Component has render props? โ Convert to compound components (2, 6) Siblings need shared state? โ Lift state to provider (4) Same UI, different data sources? โ Generic context interface (3) Building a component library? โ Apply all patterns together
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.