Conversation
Step-by-step tutorial covering all 6 Couchbase operations in ToolJet (CRUD, SQL++, FTS) using the travel-sample dataset. Includes setup paths for both Capella and self-managed clusters.
Summary of ChangesHello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed! This pull request introduces a new, detailed tutorial designed to guide users through building a functional Airline Dashboard application using ToolJet's low-code platform and Couchbase. The tutorial provides a hands-on experience, showcasing how to leverage the Couchbase marketplace plugin to perform various database operations, from basic CRUD to advanced SQL++ queries and Full-Text Search, with clear setup paths for both cloud and self-managed Couchbase environments. The primary goal is to empower users to quickly get started with the ToolJet-Couchbase integration and build internal tools without writing extensive backend or frontend code. Highlights
🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console. Using Gemini Code AssistThe full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips. Invoking Gemini You can request assistance from Gemini at any point by creating a comment using either
Customization To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a Limitations & Feedback Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here. Footnotes
|
There was a problem hiding this comment.
Code Review
This pull request adds a new, comprehensive tutorial for building an airline dashboard with ToolJet and Couchbase. The tutorial is well-structured and covers a wide range of operations. I've provided a few suggestions to enhance security, ensure the tutorial's long-term stability by version-pinning Docker images, and align the content with its stated learning objectives. Addressing the invalid frontmatter tags is also necessary to pass the validation checks.
tutorial/markdown/connectors/tooljet/tooljet-couchbase-airline-dashboard.md
Show resolved
Hide resolved
tutorial/markdown/connectors/tooljet/tooljet-couchbase-airline-dashboard.md
Outdated
Show resolved
Hide resolved
tutorial/markdown/connectors/tooljet/tooljet-couchbase-airline-dashboard.md
Outdated
Show resolved
Hide resolved
tutorial/markdown/connectors/tooljet/tooljet-couchbase-airline-dashboard.md
Outdated
Show resolved
Hide resolved
tutorial/markdown/connectors/tooljet/tooljet-couchbase-airline-dashboard.md
Outdated
Show resolved
Hide resolved
- Fix frontmatter tags to use allowed values (Data API, Connector, SQL++ (N1QL), FTS, REST API) and stay within the 6-tag limit - Remove 0.0.0.0/0 suggestion from Capella setup, add security note guiding users to find their actual IP instead - Add parameterized query example ($country) in Step 3 demonstrating safe SQL++ parameter binding via the args field - Remove parameterized queries from "Next Steps" since now covered - Pin Docker images to specific versions (couchbase:7.6.2, tooljet/tooljet-ce:v3.16.0-LTS) for tutorial reproducibility
| - nodejs | ||
| length: 30 Mins | ||
| --- | ||
|
|
There was a problem hiding this comment.
Pls Add an overview tab
|
|
||
| To follow this tutorial, you will need: | ||
|
|
||
| - A **Couchbase cluster** with the `travel-sample` bucket loaded (see setup instructions below) |
There was a problem hiding this comment.
Link to the section and rename to see Couchbase Cluster Setup
| To follow this tutorial, you will need: | ||
|
|
||
| - A **Couchbase cluster** with the `travel-sample` bucket loaded (see setup instructions below) | ||
| - A **ToolJet instance** — either [ToolJet Cloud](https://www.tooljet.com) (free tier available) or self-hosted via Docker |
There was a problem hiding this comment.
Link to the relevant section
| <details> | ||
| <summary><b>Option A: Couchbase Capella (Cloud) — Recommended</b></summary> | ||
|
|
||
| Couchbase Capella is the easiest way to get started. It has a free tier and the Data API is available out of the box. |
There was a problem hiding this comment.
Pls point to the relevant docs link for the user to navigate, like for example you can say:
Loading Travel Sample Bucket If travel-sample is not loaded in your Capella cluster, you can load it by following the instructions for your Capella Cluster:
Load travel-sample bucket in Couchbase Capella
Similarly pls add relevant links to the docs
| - Go to **Allowed IP Addresses** | ||
| - Add the IP address of your ToolJet instance (visit [whatismyip.com](https://whatismyip.com) to find your public IP if self-hosting) | ||
| > **Security Note**: Never allow `0.0.0.0/0` (all IPs). Always restrict access to specific IP addresses, even in development. | ||
| 5. **Find your Data API endpoint**: |
There was a problem hiding this comment.
Same as above, pls add relevant doc link
| couchbase:7.6.2 | ||
| ``` | ||
|
|
||
| 2. **Initialize the cluster**: |
There was a problem hiding this comment.
Is this correct for self managed? I guess it doesnt have to always be localhost
|
|
||
| 4. **Your Data API endpoint** is: | ||
| ``` | ||
| http://localhost:8091 |
| <details> | ||
| <summary><b>Option B: Self-Hosted ToolJet (Docker)</b></summary> | ||
|
|
||
| ```shell |
There was a problem hiding this comment.
I believe it is also good to rephrase/add a link to the repo/docs of tooljet where they show how to setup self hosted
| 1. In ToolJet, click the **gear icon** (bottom-left) to open **Workspace Settings** | ||
| 2. Navigate to **Marketplace** → **Plugins** | ||
| 3. Search for **"Couchbase"** | ||
| 4. Click **Install** |
There was a problem hiding this comment.
Pls add relevant screenshots
| 2. Click **+ Add new data source** | ||
| 3. Search for **"Couchbase"** and select it | ||
| 4. Fill in the connection details: | ||
|
|
There was a problem hiding this comment.
Same as above, pls add screenshot
| 3. Search for **"Couchbase"** and select it | ||
| 4. Fill in the connection details: | ||
|
|
||
| | Field | Value | |
There was a problem hiding this comment.
I dont think this table is needed, u can just rephrase to something like "Fill in the Data API Endpoint, Username and Password"
Feel free to rephrase better
| | **Password** | Your Couchbase database password | | ||
|
|
||
| <details> | ||
| <summary><b>Capella Users</b></summary> |
There was a problem hiding this comment.
The 2 sub sections Capella Users and Self managed should not be needed as they should be covered in the setup section
| 4. Configure the query: | ||
| - **Operation**: Select **Query** from the dropdown | ||
| - **SQL++ Query**: Enter the following: | ||
|
|
There was a problem hiding this comment.
Add relevant screenshot
| 2. Configure it: | ||
| - **Operation**: **Query** | ||
| - **SQL++ Query**: | ||
|
|
|
|
||
| 1. Drag a **Button** component above the table, label it "Add Airline" | ||
|
|
||
| 2. Drag a **Modal** component for the creation form. Inside it, add: |
There was a problem hiding this comment.
This is not clear, maybe adding a screenshot or rephrasing it will help better
| Before you can search, you need to create an FTS index on the airline collection. | ||
|
|
||
| <details> | ||
| <summary><b>Capella Users</b></summary> |
There was a problem hiding this comment.
The 2 sections should not be here, it should be in the pre requisites or setup.
prajwal-pai77
left a comment
There was a problem hiding this comment.
Needs some changes wrt the following:
- Add links to the documentation wherever needed and point to the right docs links
- Add screenshot/photos wherever needed to show user the dashboard
Summary
tutorial/markdown/connectors/tooljet/for building an Airline Dashboard using ToolJet and Couchbasetravel-sampledataset with setup paths for both Capella and self-managed clusters (collapsible toggle sections)Context
Couchbase was added as a marketplace plugin to ToolJet via ToolJet PR #14518 (merged Feb 2026). This tutorial provides the hands-on guide for Couchbase users to get started with the integration.
Tutorial Outline
Test plan
npm run test:frontmattervalidationtravel-sampleschema