Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
aa7711b
feat(bridge): implement DuckDB connector, migrations, and seed generator
Yashh56 Oct 13, 2026
319955a
feat(desktop): bundle DuckDB native binaries and configure Tauri pack…
Yashh56 Oct 13, 2026
1be3670
feat(frontend): add DuckDB connection handling, schema exploration, a…
Yashh56 Oct 13, 2026
e0ee836
fix(query-builder): resolve binder error with interactive handles and…
Yashh56 Oct 13, 2026
86fdd3d
fix(desktop): eliminate window close freeze with instant hide and ker…
Yashh56 Oct 13, 2026
2e56938
docs: update FEATURES.md, README.md, and AGENTS.md for DuckDB and des…
Yashh56 Oct 13, 2026
0001b56
fix(bridge): preserve capitalized engine name in SQLite and DuckDB pa…
Yashh56 Oct 13, 2026
a73882b
Merge pull request #89 from Yashh56/feat/duckdb-support
Yashh56 Oct 13, 2026
0b2fe7b
feat(bridge): implement ClickHouse database connector and driver support
Yashh56 Oct 15, 2026
7a47c19
feat(migrations): add ClickHouse DDL generation and reversible drop t…
Yashh56 Oct 15, 2026
7cd1882
feat(frontend): add ClickHouse connection UI, SQL editor support, and…
Yashh56 Oct 15, 2026
f94aa94
test(clickhouse): add Docker compose service, seed scripts, and integ…
Yashh56 Oct 15, 2026
4f98c60
docs: document ClickHouse database support in README, FEATURES, and A…
Yashh56 Oct 15, 2026
26bb453
refac: improve the UX for adding DB
Yashh56 Oct 15, 2026
680796f
perf(ai): optimize AI settings loading and update Groq and Mistral mo…
Yashh56 Oct 15, 2026
16eca0a
refac(settings): move Settings trigger to Connections header and supp…
Yashh56 Oct 15, 2026
bb3a6df
refac(command-palette): use DatabaseLogo from databases.tsx for conne…
Yashh56 Oct 15, 2026
5ab5750
fix(clickhouse): escape table keyword and fix parameter collision in …
Yashh56 Oct 15, 2026
431bf29
feat(monitoring): add real-time database monitoring support for Click…
Yashh56 Oct 15, 2026
59a457c
ci(test): add ClickHouse service container and seed step to test work…
Yashh56 Oct 16, 2026
1325e4b
feat(ux): enhance data grid, sql workspace ergonomics, and keyboard n…
Yashh56 Oct 16, 2026
8ba6993
refactor(themes): streamline to 6 core accent themes and remove legac…
Yashh56 Oct 16, 2026
1c54afb
feat(schema): strict database-specific datatypes and foreign key enfo…
Yashh56 Oct 16, 2026
c7a3638
test(discovery): include clickhouse in discovered database assertions
Yashh56 Oct 16, 2026
d231238
refac: elevated settings button
Yashh56 Oct 16, 2026
ad3e209
Merge pull request #90 from Yashh56/feat/clickhouse-support
Yashh56 Oct 16, 2026
51522b0
chore: Update version to 1.2.0 in README, package.json, and tauri.con…
Yashh56 Oct 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions .github/workflows/test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,22 @@ jobs:
--health-timeout=5s
--health-retries=5

clickhouse:
image: clickhouse/clickhouse-server:latest
env:
CLICKHOUSE_USER: testuser
CLICKHOUSE_PASSWORD: testpass
CLICKHOUSE_DB: testdb
CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT: 1
ports:
- 8123:8123
- 9000:9000
options: >-
--health-cmd="wget -q --spider http://localhost:8123/ping || exit 1"
--health-interval=10s
--health-timeout=5s
--health-retries=5

env:
REAL_POSTGRES_HOST: localhost
REAL_POSTGRES_PORT: 5432
Expand Down Expand Up @@ -93,6 +109,13 @@ jobs:
REAL_MARIADB_DATABASE: testdb
REAL_MARIADB_SSL: "false"

REAL_CLICKHOUSE_HOST: localhost
REAL_CLICKHOUSE_PORT: 8123
REAL_CLICKHOUSE_USER: testuser
REAL_CLICKHOUSE_PASSWORD: testpass
REAL_CLICKHOUSE_DATABASE: testdb
REAL_CLICKHOUSE_SSL: "false"

# SQLite — no env vars needed; tests use a temp file

steps:
Expand Down Expand Up @@ -127,6 +150,10 @@ jobs:
run: |
mysql -h 127.0.0.1 -P 3307 -u root -prootpass testdb < bridge/scripts/seed-mariadb.sql

- name: Seed ClickHouse database
run: |
node bridge/scripts/seed-clickhouse.cjs

- name: Run tests
run: |
cd bridge
Expand Down
3 changes: 2 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ RelWave uses a **Bridge Architecture** to balance performance, security, and dev
### Bridge (Node.js)

- **Runtime:** Node.js (bundled via `pkg`)
- **Database Drivers:** `pg` (PostgreSQL), `mysql2` (MySQL/MariaDB), `better-sqlite3` (SQLite)
- **Database Drivers:** `pg` (PostgreSQL), `mysql2` (MySQL/MariaDB), `better-sqlite3` (SQLite), `@duckdb/node-api` (DuckDB), `@clickhouse/client` (ClickHouse)
- **Version Control:** `simple-git`
- **Logging:** `pino`
- **Security:** `@napi-rs/keyring` for encrypted credential storage
Expand Down Expand Up @@ -53,6 +53,7 @@ RelWave uses a **Bridge Architecture** to balance performance, security, and dev
3. **Styling:** Use Tailwind CSS 4 utility classes. Prefer components from `src/components/ui`.
4. **Error Handling:** Use the established JSON-RPC error format to ensure errors from the bridge are gracefully handled in the UI via `sonner` notifications.
5. **Testing:** Bridge logic should be tested in `bridge/__tests__` using Jest.
6. **Native Modules & Binaries:** When updating native C/C++ drivers (such as `better-sqlite3` or DuckDB), verify both development execution and packaged Tauri builds via `scripts/bundle-duckdb.cjs` and `tauri.conf.json` resource mappings.

## 📝 Conventions

Expand Down
189 changes: 149 additions & 40 deletions FEATURES.md

Large diffs are not rendered by default.

6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

_RelWave brings the power of native Git versioning, visual ER diagrams, and seamless schema management into one blazingly fast desktop application. Built for developers who demand more._

[![Version](https://img.shields.io/badge/version-1.1.0-0066ff?style=for-the-badge&logo=semver)](https://github.com/Relwave/relwave-app/releases)
[![Version](https://img.shields.io/badge/version-1.2.0-0066ff?style=for-the-badge&logo=semver)](https://github.com/Relwave/relwave-app/releases)
[![License](https://img.shields.io/badge/license-MIT-00cc66?style=for-the-badge)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux-1f2937?style=for-the-badge&logo=windows)](https://github.com/Relwave/relwave-app/releases)
[![Tauri](https://img.shields.io/badge/built%20with-Tauri-FFC131?style=for-the-badge&logo=tauri)](https://tauri.app/)
Expand Down Expand Up @@ -40,7 +40,7 @@ _RelWave brings the power of native Git versioning, visual ER diagrams, and seam
<b>Native Core</b>
<br />
<br />
Direct connections via native drivers. Zero browser overhead. Pure speed.
Direct connections via native drivers (PostgreSQL, MySQL, SQLite, DuckDB, ClickHouse). Zero browser overhead. Pure speed.
</td>
<td align="center" width="25%">
<br />
Expand Down Expand Up @@ -133,7 +133,7 @@ RelWave uses a **three-layer bridge architecture**. React owns the user experien

<img width="1565" height="518" alt="image" src="https://github.com/user-attachments/assets/defdc3b7-7555-40ac-bf97-b1cb9420b325" />

The request path is **React UI -> Tauri command -> Node.js JSON-RPC handler -> service -> database, Git, local storage, monitoring, or LLM provider**. Responses return through the same boundary in reverse. Long-running SQL queries additionally stream `query.result`, `query.progress`, and `query.done` notifications back to the React client. The Node.js bridge contains the database connectors, Git service, AI services, monitoring services, project stores, credential access, and SSH tunnel handling.
The request path is **React UI -> Tauri command -> Node.js JSON-RPC handler -> service -> database, Git, local storage, monitoring, or LLM provider**. Responses return through the same boundary in reverse. Long-running SQL queries additionally stream `query.result`, `query.progress`, and `query.done` notifications back to the React client. The Node.js bridge contains the database connectors (PostgreSQL, MySQL/MariaDB, SQLite, DuckDB, ClickHouse), Git service, AI services, monitoring services, project stores, credential access, and SSH tunnel handling.

<br />

Expand Down
32 changes: 32 additions & 0 deletions bridge/.env.example
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# Bridge test and local development environment
# Copy this file to .env and adjust values if you need custom database endpoints.

REAL_POSTGRES_HOST=localhost
REAL_POSTGRES_PORT=5432
REAL_POSTGRES_USER=testuser
REAL_POSTGRES_PASSWORD=testpass
REAL_POSTGRES_DATABASE=testdb
REAL_POSTGRES_SSL=false
REAL_POSTGRES_SSLMODE=disable

REAL_MYSQL_HOST=localhost
REAL_MYSQL_PORT=3306
REAL_MYSQL_USER=testuser
REAL_MYSQL_PASSWORD=testpass
REAL_MYSQL_DATABASE=testdb
REAL_MYSQL_SSL=false

REAL_MARIADB_HOST=localhost
REAL_MARIADB_PORT=3307
REAL_MARIADB_USER=testuser
REAL_MARIADB_PASSWORD=testpass
REAL_MARIADB_DATABASE=testdb
REAL_MARIADB_SSL=false

REAL_CLICKHOUSE_HOST=localhost
REAL_CLICKHOUSE_PORT=8123
REAL_CLICKHOUSE_USER=testuser
REAL_CLICKHOUSE_PASSWORD=testpass
REAL_CLICKHOUSE_DATABASE=testdb
REAL_CLICKHOUSE_SSL=false

3 changes: 2 additions & 1 deletion bridge/.gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,5 @@ node_modules
dist
coverage
.env
.env*
.env.*
!.env.example
95 changes: 95 additions & 0 deletions bridge/__tests__/clickhouseUrl.test.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
import { cleanClickHouseUrl, parseClickHouseUrl } from "../src/utils/clickhouseUrl";
import { describe, expect, it } from "@jest/globals";

describe("ClickHouse URL Utilities", () => {
describe("cleanClickHouseUrl", () => {
it("should handle empty or undefined input", () => {
expect(cleanClickHouseUrl("")).toBe("");
expect(cleanClickHouseUrl(undefined)).toBe("");
expect(cleanClickHouseUrl(" ")).toBe("");
});

it("should strip markdown links", () => {
expect(
cleanClickHouseUrl(
"[https://demo.clickhouse.cloud:8443](https://demo.clickhouse.cloud:8443)",
),
).toBe("https://demo.clickhouse.cloud:8443");
expect(cleanClickHouseUrl("[https://demo.clickhouse.cloud:8443]()")).toBe(
"https://demo.clickhouse.cloud:8443",
);
});

it("should strip enclosing single/double quotes and backticks", () => {
expect(cleanClickHouseUrl("'https://demo.clickhouse.cloud:8443'")).toBe(
"https://demo.clickhouse.cloud:8443",
);
expect(cleanClickHouseUrl('"https://demo.clickhouse.cloud:8443"')).toBe(
"https://demo.clickhouse.cloud:8443",
);
expect(cleanClickHouseUrl("`https://demo.clickhouse.cloud:8443`")).toBe(
"https://demo.clickhouse.cloud:8443",
);
});

it("should convert clickhouses:// protocol to https://", () => {
expect(cleanClickHouseUrl("clickhouses://demo.clickhouse.cloud:8443")).toBe(
"https://demo.clickhouse.cloud:8443",
);
});

it("should convert clickhouse:// protocol properly based on SSL / port", () => {
expect(cleanClickHouseUrl("clickhouse://demo.clickhouse.cloud:8443")).toBe(
"https://demo.clickhouse.cloud:8443",
);
expect(cleanClickHouseUrl("clickhouse://localhost:8123")).toBe("http://localhost:8123");
});

it("should prepend https:// for clickhouse.cloud or port 8443 if no scheme provided", () => {
expect(cleanClickHouseUrl("demo.clickhouse.cloud:8443")).toBe(
"https://demo.clickhouse.cloud:8443",
);
expect(cleanClickHouseUrl("demo.clickhouse.cloud")).toBe("https://demo.clickhouse.cloud");
});

it("should prepend http:// for localhost:8123 if no scheme provided", () => {
expect(cleanClickHouseUrl("localhost:8123")).toBe("http://localhost:8123");
});

it("should strip trailing slashes", () => {
expect(cleanClickHouseUrl("https://demo.clickhouse.cloud:8443/")).toBe(
"https://demo.clickhouse.cloud:8443",
);
});
});

describe("parseClickHouseUrl", () => {
it("should parse standard cloud url", () => {
const parsed = parseClickHouseUrl("https://of8remuy3t.ap-south-1.aws.clickhouse.cloud:8443");
expect(parsed.host).toBe("of8remuy3t.ap-south-1.aws.clickhouse.cloud");
expect(parsed.port).toBe(8443);
expect(parsed.ssl).toBe(true);
expect(parsed.database).toBe("default");
});

it("should parse url with embedded user and password", () => {
const parsed = parseClickHouseUrl(
"https://myuser:secret123@of8remuy3t.ap-south-1.aws.clickhouse.cloud:8443/analytics",
);
expect(parsed.host).toBe("of8remuy3t.ap-south-1.aws.clickhouse.cloud");
expect(parsed.port).toBe(8443);
expect(parsed.ssl).toBe(true);
expect(parsed.user).toBe("myuser");
expect(parsed.password).toBe("secret123");
expect(parsed.database).toBe("analytics");
});

it("should parse localhost http url", () => {
const parsed = parseClickHouseUrl("http://localhost:8123/default");
expect(parsed.host).toBe("localhost");
expect(parsed.port).toBe(8123);
expect(parsed.ssl).toBe(false);
expect(parsed.database).toBe("default");
});
});
});
Loading
Loading