Quick Start Guide
This quick start guide will familiarize you with setting up the Catalyst work environment in under ten minutes. With this guide, you can quickly learn the basic steps involved in developing a Catalyst application.
You can access detailed step-by-step tutorials on building applications and microservices involving different Catalyst components from the Tutorials section.
- Node.js and NPM for your platform to install Catalyst CLI and to develop Node.js functions
- Java SE Development Kit to develop Java functions
- Any IDE tool for coding the client or the functions.
Step 1: Create a Catalyst project
The first step in developing a Catalyst application is to create a Catalyst project for it.
- Log in to the Catalyst console and click Create a new Project.
- Enter the project's name in the pop-up window.
- Read and accept Zoho Catalyst's terms of service and click Create.
- Click Access Project to open it.
You can now set up and work with the Catalyst components from the console. Refer to the Component Help resources to learn about the Catalyst components in detail.
Step 2: Install Catalyst CLI
Install Catalyst CLI to develop, test, and deploy Catalyst applications from your local system. Refer to this help page for a detailed guide.
Execute this command in your terminal:
$ npm install -g zcatalyst-cli
Execute this command to verify if the CLI is properly installed:
$ catalyst --version
You will now be able to access the catalyst command from your terminal. Refer to the CLI help resources for detailed help with the CLI commands and actions.
Step 3: Log in from your CLI
- Execute this command to log in to your Zoho account from the CLI:
$ catalyst login
- Press Y to allow Catalyst to collect CLI error reports and press Enter.
- Sign in using your credentials in the Zoho accounts login page.
- Click Accept to provide data access permissions to the CLI.
- Close the browser window and continue using the CLI in your terminal.
Step 4: Initialize the project from the CLI
- Create a folder for the project on your local machine and navigate to it from the terminal.
- Execute this command from that directory to initialize a Catalyst project in it:
$ catalyst initNote: The first Catalyst project can only be created from the web console, and not from the CLI. However, you can create subsequent projects directly from the CLI.
- Select the components that you need to set up for your Catalyst application and press Enter. You can initialize functions and the client.
- Associate the directory with a Catalyst project by selecting a project from the list and press Enter.
- If you initialize a function, select a function type and the stack, and press Enter.
- If you initialize a Java function, provide the reference name and the main class name, then install the Catalyst Java SDK package.
- If you initialize a Node.js function, provide the values for the package name, the entry point file name, and the author's email address. Install the dependencies when prompted.
- If you initialize the client, provide a name for the client package.
The components will be installed and the project directory will be set up with the necessary dependencies and configuration. Refer to the standard project directory structure help page for details.
Step 5: Develop the application
You can now work with the components you initialized in your Catalyst project and use any IDE tool of your choice to code the functions or the client. Refer to the following help documentations for detailed help on working with the Catalyst SDK and API resources:
- Java SDK help documentation
- Node.js SDK help documentation
- Web SDK help documentation
- API help documentation
Step 6: Test the application locally
After you develop the Catalyst application or microservice, you can test it locally from the CLI before deploying it to the Catalyst web console.
Execute this command from your project directory (CATALYST_PROJECT_HOME):
$ catalyst serve
You can access the client from its local URL displayed in the CLI, and test it. You can use the catalyst serve command with several options.
Step 7: Deploy the project
After you test the application, you can deploy it to the remote console by executing this command from your project directory:
$ catalyst deploy
Your application can now be accessed from its production URL. You can also host the application directly from the console through web client hosting.
Access Tutorials to try out some sample applications.