Introduction
Reactopia grows one copy-pasteable building block at a time. If you have a component, hook, utility, or helper you reuse across projects, you can add it here so others can discover and use it.
What a good contribution looks like
- Copy-pasteable. No private dependencies, no project-specific imports. A developer should be able to copy the file into their app and run it.
- Documented props. Every prop, argument, or option is listed with its default.
- Minimal example. One short snippet showing the common case.
- Honest status. New additions land as Beta. Only mark Live when the code is used in real projects.
How to add a component
- Fork the repository and create a branch for your addition.
- Add an MDX doc in
public/docs/contents/following the existingcontent_Separator.mdxstructure:!intro,!!stepswith aCodeWithTabsblock holding the full implementation,!!customization,!outro. - Register the entry in the
allDocsarray insrc/components/componentsUi/data.tsxwith real metadata:kind,platform,status,updated,sourcePath, anddependencies. Setpublished: falseuntil the docs are complete. - Open a pull request describing what the block does, when to use it, and which environment you tested it in (React, React Native, or web).
What happens next
Maintainers review for correctness, copy-pasteability, and accurate metadata. Small, focused additions (one block per pull request) get reviewed fastest.
Footer
📚 Every documented block needs a clear path: what it is, a live example, copyable code, setup steps, and a source link. If your addition keeps that path intact, it belongs in Reactopia.