Collab Actions is a collection of tools designed to help create miniapps for the Collab.Land marketplace. By using Collab Actions, the setup and configuration of the Collab.Land infrastructure, which includes Docker, AWS, security measures, and authentication, is automatically managed for you.
Collab.Land Action Templates
To get started, use any of the Collab Action templates we provide on GitHub:
If you don't want to use a template, you can create your own Collab Action from scratch. Check out Build a Custom Collab Action for detailed instructions.
OSS Miniapp Examples
If you would prefer to get some insights or explore the implementation details of some existing miniapps, here are a few repositories to get you started:
- Node.js and npm (Node Package Manager) must be installed on your system.
Using a Collab Action template
- Fork the Action template repository from GitHub.
- Clone the project.
git clone [PROJECT_URL.git]
- Navigate to the project directory and install the project dependencies.
- Build the project
npm run build
Run the Action server locally
To run the server, you'll need a public key for the Action. You can get the public key from the Collab.Land QA config endpoint by going to https://api-qa.collab.land/config from your browser:
Download and install
Run the Action server:
npm run server -- DhF7T98EBmH1ZFmdGJvBhkmdn3BfAqc3tz8LxER8VH2q
This will start the server on port 3000. From a different terminal window, run
ngrokon the same port to expose the server to other applications on the internet:
ngrok http 3000
Copy the HTTPS URL, for example:
Your URL will be different.
To get the Action URL, append
/hello-action to the end of the ngrok URL.
For example: https://0c49-2601-646-9e00-80-3964-47d-7146-ff13.ngrok.io/hello-action
Repeat the same process to get the Action URL for the other Action types:
/button-action- Returns a button for users to interact with and
/popup-action- Shows a pop up modal to the users for subsequent interactions.
Test the Actions in a Discord server
With the Action server running, you can now test the Action in a Discord server using the Collab.Land QA bot. But first, you'll need to install the Collab.Land TestFlight mini-app on your Discord server. The steps are outlined below.
- Create a test Discord server
- Install the Collab.Land QA bot on your Discord server
- Create a community wallet
- Install the Collab.Land TestFlight mini-app on your Discord server
- Install the Action on your Discord server
- Test the Action
Create a test Discord server
Follow the instructions on the Discord documentation to create a test Discord server.
Install the Collab.Land QA Bot on Discord
- Sign in to the Discord server where you would like to run your Action.
- Invite the QA Bot to your server.
- Grant the required permissions:
Upon Authorization, you will be redirected to the Collab.Land Command Center. It is a password-protected site with the following credentials:
To access the Command Center again, go to: https://cc-qa.collab.land
Create a Community Wallet
- In the Command Center, go to the Marketplace tab.
- Click on the "Create community wallet" button.
- You will receive a message saying "Wallet successfully created” and access to the marketplace apps.
Install the TestFlight Mini-App
- In the Marketplace tab, you will see all the available mini-apps, including
- Click on the "Install" button for the Test Flight app.
- The mini-app modal will pop up for you, click "Free Install" to install the app.
Go to the Discord server where you installed the Collab.Land QA bot and type
/test to see all the newly installed slash commands that are made available through the “Test Flight” mini app.
Install the Action on your Discord server
/test-flight install command and enter the Action URL you created earlier using ngrok in the
action-url field. For example, here we entered: https://0c49-2601-646-9e00-80-3964-47d-7146-ff13.ngrok.io/hello-action to test the
You will get a message with a description of the Action that you are about to install. Click the “Install the action” button. You will get a confirmation that the “action is installed”.
Test the Action
You and your users can now use the Action in the Discord server by running your slash commands!
To customize this Action and test it locally, follow this guide.