Catalyst React Plugin (Modernized)

!catalyst
!npm
!license
!build-tools

> Note: This is a fork of the official zcatalyst-cli-plugin-react from the Zoho Catalyst Team, modernized to support both Vite and Webpack build tools.

A modernized React plugin for Catalyst CLI with support for both Vite and Webpack build tools. Develop and deploy React applications with Catalyst using modern or traditional build tools.

Why This Fork?

The official plugin only supports Webpack/Create React App. This fork adds:
- ✨ Vite Support - Fast, modern build tool with HMR
- 🔄 Automatic Detection - Seamlessly works with both Vite and Webpack
- 🏗️ Adapter Architecture - Extensible design for future build tools
- 📦 Full Backward Compatibility - Existing Webpack projects work without changes

Plugin Capabilities

- This plugin allows you to serve and debug the React Application with Catalyst.
- With this plugin you'll be able to build a production ready version of your React Application and deploy it to Catalyst remote console.
- Supports both Vite and Webpack build tools with automatic detection.

Prerequisites

ZCatalyst-CLI: To install ZCatalyst-CLI with npm, use this command
``bash
npm install -g zcatalyst-cli
`
Check this documentation to get started with React in Catalyst
> Note: zcatalyst-cli of versions 1.11.0 and above supports this plugin.

Build Tool Support

This plugin automatically detects and supports both modern and traditional React build tools:
- Vite - Fast, modern build tool with HMR (recommended for new projects)
- Webpack - Traditional build tool via Create React App (react-scripts)

The plugin automatically detects which build tool your project uses based on your dependencies and configuration files.

$3

- Build Tool Detection - How the plugin detects your build tool
- Vite Migration Guide - Step-by-step guide to migrate from Webpack to Vite

$3

`bash

Create a new Vite + React project

npm create vite@latest my-app -- --template react-ts

Install the plugin

cd my-app
npm install @hrica/zcatalyst-cli-plugin-react --save-dev

Configure catalyst.json

The plugin will automatically detect Vite

`

Configuring Plugin

The Plugin can be installed in two ways and needed to be configured in the catalyst.json configuration file.

>Note: When setting up the React App from ZCatalyst-CLI the CLI will take care of the configuration process.

$3

The plugin can be installed in the global NPM _node_modules_ directory and configured as follows

Installation
`bash
npm install @hrica/zcatalyst-cli-plugin-react -g
`
_catalyst.json_
`json
{
"client": {
"source": "react-app",
"plugin": "@hrica/zcatalyst-cli-plugin-react"
}
}
`

$3

The plugin can be installed in the local _node_modules_ directory of the React App and configured as follows

Installation
`bash


to be executed within the React App directory


npm install @hrica/zcatalyst-cli-plugin-react --save-dev
`

_catalyst.json_
`json
{
"client": {
"source": "react-app",
"plugin": "react-app/node_modules/@hrica/zcatalyst-cli-plugin-react"
}
}
`

Credits and Acknowledgments

This project is a fork of the official zcatalyst-cli-plugin-react created and maintained by the Zoho Catalyst Team.

$3


- Package: zcatalyst-cli-plugin-react
- Author: Catalyst (https://www.zoho.com/catalyst/)
- Repository: Official Zoho Catalyst CLI Plugin for React
- License: MIT

$3

- Package: @hrica/zcatalyst-cli-plugin-react`
- Maintainer: Harivonjy Rica
- Key Enhancement: Added Vite support alongside existing Webpack support
- Architecture: Introduced adapter pattern for multi-build-tool support
- Compatibility: 100% backward compatible with original plugin

$3

This fork extends the original plugin with:
- ✨ Vite build tool support
- 🔄 Automatic build tool detection
- 🏗️ Modular adapter architecture
- 📚 Enhanced documentation
- 🧪 Comprehensive integration tests

All original Webpack/Create React App functionality remains intact and unchanged.

$3

Contributions are welcome! If you'd like to contribute:
1. Fork this repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

$3

MIT License - Same as the original project

$3

- Issues: GitHub Issues
- Documentation: docs/
- Original Plugin: zcatalyst-cli-plugin-react
- Catalyst Platform: Zoho Catalyst

---

Disclaimer: This is an independent fork and is not officially affiliated with or endorsed by Zoho Corporation or the Catalyst Team. For the official plugin, please use zcatalyst-cli-plugin-react.