Skip to main content

​
Migration FAQ

Common questions about migrating from npm packages to CLI components.

​
General Questions

Yes. The CLI components are UI only. They depend on @replyke/react-js for data fetching, caching, authentication, and core functionality.
{
  "dependencies": {
    "@replyke/react-js": "^6.0.0",
    "@replyke/ui-core-react-js": "^6.0.0"
  }
}
Not recommended. Pick one approach per project. Mixing them will be confusing and increase bundle size.
You’ll need to manually apply your customizations to the source files. Use the Mapping Guide to find where each callback maps to.The benefit: You’ll have even more control since you can customize anything, not just exposed callbacks.
Yes. The backend data is unchanged. CLI components use the same APIs and data models.Your existing comments, votes, and user data will work seamlessly.
No, but recommended. The old npm packages are deprecated but still functional. Migrate when convenient.New features and improvements will only be added to CLI components going forward.

​
Technical Questions

Yes! It’s Apache 2.0 licensed. You can fork, modify, and even publish your own variant.
Currently: Re-run add to a different directory and manually merge changes.Future: A diff command will show what changed, making updates easier while preserving customizations.
Yes. CLI components are just React components. They work with any React framework.
Yes. All component files are .tsx with full type annotations.
Manually, yes (rewrite styles). Automatically, not yet.Recommendation: Choose wisely during init. If you need to switch, delete components and re-add with new configuration.

​
Customization Questions

  1. Colors: Search for hex codes or Tailwind classes and replace
  2. Layout: Edit main component files (threaded-comment-section.tsx, etc.)
  3. Functionality: Edit component files and hooks
See Customization Guide for examples.
Option 1: Use version control (git) to revert your changes
git checkout src/components/comments-threaded/
Option 2: Delete and reinstall
rm -rf src/components/comments-threaded
npx @replyke/cli add comments-threaded
Since there’s no automatic update system yet, you won’t “break” updates.When updates become available, you’ll manually merge changes into your customized files.Tip: Comment your customizations clearly:
// CUSTOM: Changed color to match brand
color: '#9333EA'

​
Support

Yes! The components are open source. Contributions welcome:
  • UI improvements
  • New component variants
  • Bug fixes
  • Documentation improvements
Visit the GitHub repo to contribute.

​
Next Steps

Migration Guide

Complete migration walkthrough

Mapping Guide

Callback-to-file mapping

Customization

Customize components

Quick Start

Get started with CLI