Initialize the Project from the CLI

You can now begin working on your Catalyst project from the CLI. The first step is to initialize the project in an empty directory. This will be the home directory of your project and all of the project files will be saved in it.

You can learn more about this from the Project Directory Structure help page. You can learn about initializing a project in detail from the CLI help documentation.

For this application, we will initialize a Basic I/O function, which will contain the logic for Custom User Validation and a Basic web app as the client component.

Note: Ensure that you enter the function's package name or class name exactly as instructed, because the application's code contains the same name.
  1. Create a folder for the project on your local machine and navigate to it from the terminal.

  2. Initialize a project by executing the following command from that directory:

copy
$
catalyst init
  1. Navigate using the arrow keys, select your preferred portal, and press the Enter key. If you have no other organizations associated with the account, then the default one will be selected automatically. catalyst_authorization_portal_multiorg_choice
Note: You can find out more about Catalyst’s multi-org portal feature from this help document.
  1. The CLI will now ask you to associate a Catalyst project with the directory. Associate it with the project that we created earlier from the console. Select Authorization Portal from the list and press Enter. catalyst_authentication_project_select

  2. Navigate using the arrow keys and select Functions, Client using the space bar. Press Enter to initialize. select_project_components

  3. The CLI will initiate the function setup. Select Basic IO as the function type for your Custom User Validation function. select_basicio

  4. Select the latest runtime of Python as the function stack. select-runtime

  5. Enter “authorization_portal_function” as the package name, “index.js” as the entry point, and your email address as the author, then press Enter. Alternatively, you can press Enter without entering inputs to fill in the default values. The CLI will prompt the initialization of the Node dependencies. Press Y to confirm the installation, and press Enter to confirm your choice. The Node modules will be installed. python-function-setup

The CLI will now initiate the client setup.

  1. Select Basic web app and press Enter to initialize your client as a basic web app. basic_webapp

  2. Enter a name for your client package and press Enter. For the purposes of this tutorial, we are naming our client package “zylkertechnologies”. You can use the same of provide a name of your choice. client_name

The Catalyst initialization is now complete.

The project directory is now set up with the client directory and the functions directory along with configuration files and dependencies. The project directory also contains the catalyst.json configuration file and a hidden .catalystrc file.

The structure of your project directory should now appear as shown below: basic-app-structure

  1. Select React web app and press Enter to initialize your client as a React web app. select_react

  2. Select JavaScript as the React app type and press Enter select_js

  3. Enter “zylkertechnologies” as the name of your client package and click Enter. You can also provide any name of your choice. All of the required React packages, such as “react,” “react-dom,” and “react-scripts” will be installed through the Catalyst React plugin (zcatalyst-cli-plugin-react). client_setup

    The client is now successfully initialized as a React web application. complete_init

The client directory will be created in the standard structure in the project directory.

This is the structure of the Authorization Portal project’s directory if the client is initialized as a React app. react_app_structure

Catalyst initialization is now complete.

Last Updated 2024-10-04 18:17:21 +0530 +0530