@hrica/zcatalyst-cli-plugin-react

Catalyst React Plugin (Modernized)

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

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.

Documentation

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

Quick Start with Vite

# 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.

Global installation

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

Installation

npm install @hrica/zcatalyst-cli-plugin-react -g

catalyst.json

{
    "client": {
        "source": "react-app",
        "plugin": "@hrica/zcatalyst-cli-plugin-react"
    }
}

Local installation

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

Installation

# to be executed within the React App directory
npm install @hrica/zcatalyst-cli-plugin-react --save-dev

catalyst.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.

Original Project

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

This Fork

• Package: @hrica/zcatalyst-cli-plugin-react
• Maintainer: Harivonjy Rica [e-mail]
• 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

What's Different?

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.

Contributing

Contributions are welcome! If you'd like to contribute:

• Fork this repository
• Create a feature branch
• Make your changes
• Add tests
• Submit a pull request

License

MIT License - Same as the original project

Support

• 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.