Workshop.Apps.Development

Guide to get started with Rocket.Chat Apps Development Workshop.

Getting Started

1. Install rc-apps globally:

  npm install -g @rocket.chat/apps-cli

To verify that the installation was successful, run:

  rc-apps -v

The output should be the version of the rc-apps CLI. Example:

@rocket.chat/apps-cli/1.12.0 darwin-arm64 node-v20.18.1

Notice the "darwin-arm64" part of the output. This is the platform that the CLI is running on. The platform will be different depending on the operating system you are using.

2. Clone the repository:

git clone https://github.com/RocketChat/Apps.Chat.Summarize.git

3. Change to the directory of the repository:

cd Apps.Chat.Summarize/app 

4. Modify the following:

• In the app.json file:
  • nameSlug - The App username, which must be unique. Currently, the value is ai-chat-summarizer change it to something unique, e.g., ai-chat-summarizer-<yourname>.
  • id - The App UUID, which must be unique. You can generate a new UUID using an online UUID generator. Head to https://www.uuidgenerator.net/version4 and click on the "Generate" button. Copy the generated UUID and paste it in the id field. Please do NOT use 0034268f-e49a-4113-be51-4a5ca77aeeb1 as it is already in use.
  • author - Modify to include your name.
• Replace the icon.png file with your own icon. We recommend using an AI-generated image. Consider using prompts related to your initial. Use a prompt like '[your concept here], avatar' at an AI image generator like https://image.pollinations.ai/.

Note you can modify the text as https://image.pollinations.ai/prompt/{prompt} where {prompt} is the text you want to generate the image for.

5. Open the file /commands/SummarizeCommand.ts and modify the command field to a unique command name. Currently, the value is chat-summary change it to something unique, e.g., chat-summary-<yourname>.

6. Run the following command to install the dependencies:

npm install

7. Run the following command to build the app:

rc-apps package

8. Run the following command to deploy the app:

rc-apps deploy --url <your_server_url> --username <your_username> --password <your_password>