Skip to content

Add ToolJet + Couchbase integration tutorial#96

Open
teetangh wants to merge 5 commits intomainfrom
tutorial/tooljet-couchbase-airline-dashboard
Open

Add ToolJet + Couchbase integration tutorial#96
teetangh wants to merge 5 commits intomainfrom
tutorial/tooljet-couchbase-airline-dashboard

Conversation

@teetangh
Copy link
Copy Markdown
Contributor

Summary

  • Adds a new tutorial under tutorial/markdown/connectors/tooljet/ for building an Airline Dashboard using ToolJet and Couchbase
  • Covers all 6 Couchbase plugin operations: Get Document, Create Document, Update Document, Delete Document, SQL++ Query, and Full-Text Search
  • Uses the travel-sample dataset with setup paths for both Capella and self-managed clusters (collapsible toggle sections)
  • Follows existing tutorial conventions (frontmatter schema, connectors directory, ~30 min length)

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

  1. Prerequisites (Couchbase cluster + ToolJet instance setup)
  2. Install the Couchbase plugin from ToolJet Marketplace
  3. Configure the data source (Data API URL, credentials)
  4. SQL++ query to list airlines
  5. Display results in a Table component
  6. View airline details (Get Document)
  7. Create new airline (Create Document)
  8. Edit airline (Update Document)
  9. Delete airline (Delete Document)
  10. Full-Text Search with FTS index

Test plan

  • Verify frontmatter passes npm run test:frontmatter validation
  • Verify all SQL++ queries are valid against travel-sample schema
  • Verify tutorial renders correctly on the Developer Portal
  • Test both Capella and self-managed setup paths end-to-end

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.
@teetangh teetangh requested a review from a team as a code owner March 24, 2026 10:21
@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, 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 Tutorial Content: Added a comprehensive tutorial demonstrating the integration of ToolJet with Couchbase to build an Airline Dashboard.
  • Couchbase Operations Covered: The tutorial covers all six Couchbase plugin operations: Get Document, Create Document, Update Document, Delete Document, SQL++ Query, and Full-Text Search.
  • Flexible Setup Options: Included detailed setup instructions for both Couchbase Capella (cloud) and self-managed clusters, utilizing the travel-sample dataset.
  • Adherence to Standards: Ensured the new tutorial follows existing documentation conventions, including frontmatter schema and placement within the connectors directory.

🧠 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 Assist

The 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 /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

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 .gemini/ folder in the base of the repository. Detailed instructions can be found here.

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

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@teetangh teetangh self-assigned this Mar 24, 2026
- 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
@teetangh teetangh requested a review from prajwal-pai77 March 24, 2026 10:47
Copy link
Copy Markdown
Contributor

@prajwal-pai77 prajwal-pai77 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

- Add Overview section at top of tutorial
- Add anchor links in Prerequisites to Couchbase Cluster Setup and
  ToolJet Setup sections
- Add Couchbase docs links for loading travel-sample and allowing IPs
  in Capella
- Clarify self-managed Data API endpoint is server hostname/IP, not
  always localhost
- Add ToolJet self-hosted setup docs link
- Remove redundant connection details table in Step 2, replace with prose
- Remove duplicate Capella/Self-Managed sub-sections inside Step 2
- Move FTS index creation into Prerequisites section with cross-reference
  in Step 9
@teetangh
Copy link
Copy Markdown
Contributor Author

teetangh commented Apr 7, 2026

Review feedback addressed (commits `14700d3`, `cdeb5cc`)

Fixed

# Comment Change
1 Add an overview section Added `## Overview` heading before the intro paragraph
2 Link prerequisite to Couchbase Cluster Setup section Added anchor link `#couchbase-cluster-setup`
3 Link prerequisite to ToolJet Setup section Added anchor link `#tooljet-setup`
4 Add docs link for loading travel-sample in Capella Added link to Couchbase Capella import docs
5 Add docs link for allowing IPs in Capella Added link to Allow IP Address on Capella
6 Self-managed endpoint doesn't have to be localhost Clarified both the browser URL and Data API endpoint to use ``, with a note that `localhost` applies only when running locally
7 Same as above (Data API endpoint) Same fix applied to the Data API endpoint code block
8 Add link to ToolJet self-hosted setup docs Added link to ToolJet self-hosting guide
9 Remove the connection details table in Step 2 Replaced table with a single prose sentence
10 Remove duplicate Capella/Self-Managed sub-sections inside Step 2 Removed both `
Details` blocks — fully covered in Prerequisites
11 FTS index sections should be in Prerequisites, not Step 9 Moved both Capella and Self-Managed FTS index creation into a new `### Create an FTS Index` subsection in Prerequisites; Step 9 now has a cross-reference link
12 Add screenshots for Steps 2, 3, parameterized query, Get/Create/Update/Delete Document, FTS Search Added 8 screenshots from the ToolJet Couchbase plugin docs, co-located with the markdown file

Screenshots added:

Step Screenshot
Step 2 — Configure data source `connection-v2.png` — connection form
Step 3 — Create SQL++ query `listops.png` — operations dropdown, `query-v2.png` — configured query
Step 5 — Get Document `get-doc.png`
Step 6 — Create Document `create-doc.png`
Step 7 — Update Document `update-doc.png`
Step 8 — Delete Document `delete-doc.png`
Step 9 — FTS Search `fts-search-v2.png`

Still pending — Step 1 (Install plugin) screenshot

No existing screenshot for the Marketplace install flow. Needs manual capture from a live ToolJet instance.

Not changed

Line 289 (Step 6 modal form) — The comment noted this section was unclear and suggested a screenshot or rephrasing. The text explicitly lists every input component by name, label, and placeholder, so a rephrasing alone would not add meaningful clarity. This is best addressed by the screenshot pass above.

teetangh added 2 commits April 7, 2026 13:01
- Add 8 screenshots from ToolJet docs to the tutorial directory
- Embed screenshots at appropriate steps: connection config, operations
  dropdown, SQL++ query, Get/Create/Update/Delete Document, FTS Search
- Screenshots are co-located with the markdown file per repo convention
- Move query-v2.png to parameterized query section (it shows args/options,
  not the basic listAirlines query)
- Add captions noting _default scope/collection in CRUD screenshots
  should be replaced with inventory/airline
- Add caption noting hotel-index in fts-search-v2.png should be
  replaced with airline-name-index
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants