feat: Add SingleStore Helios database support

.changeset/config.json

@@ -8,4 +8,4 @@
 	"baseBranch": "main",
 	"updateInternalDependencies": "patch",
 	"ignore": ["@better-t-stack/backend", "web"]
-}
+}

.changeset/kind-geese-sell.md

@@ -0,0 +1,5 @@
+---
+"create-better-t-stack": minor
+---
+
+Add SingleStore Helios database support

apps/cli/README.md

@@ -36,9 +36,9 @@ Follow the prompts to configure your project or use the `--yes` flag for default
 | **Backend**              | • Hono<br>• Express<br>• Elysia<br>• Next.js API routes<br>• Convex<br>• Fastify<br>• None                                                                                                                                                                 |
 | **API Layer**            | • tRPC (type-safe APIs)<br>• oRPC (OpenAPI-compatible type-safe APIs)<br>• None                                                                                                                                                                            |
 | **Runtime**              | • Bun<br>• Node.js<br>• Cloudflare Workers<br>• None                                                                                                                                                                                                       |
-| **Database**             | • SQLite<br>• PostgreSQL<br>• MySQL<br>• MongoDB<br>• None                                                                                                                                                                                                 |
+| **Database**             | • SQLite<br>• PostgreSQL<br>• MySQL<br>• MongoDB<br>• SingleStore<br>• None                                                                                                                                                                                |
 | **ORM**                  | • Drizzle (TypeScript-first)<br>• Prisma (feature-rich)<br>• Mongoose (for MongoDB)<br>• None                                                                                                                                                              |
-| **Database Setup**       | • Turso (SQLite)<br>• Cloudflare D1 (SQLite)<br>• Neon (PostgreSQL)<br>• Supabase (PostgreSQL)<br>• Prisma Postgres (via Prisma Accelerate)<br>• MongoDB Atlas<br>• None (manual setup)                                                                    |
+| **Database Setup**       | • Turso (SQLite)<br>• Cloudflare D1 (SQLite)<br>• Neon (PostgreSQL)<br>• Supabase (PostgreSQL)<br>• Prisma Postgres (via Prisma Accelerate)<br>• MongoDB Atlas<br>• SingleStore Helios (cloud-hosted SingleStore)<br>• None (manual setup)                          |
 | **Authentication**       | Better-Auth (email/password, with more options coming soon)                                                                                                                                                                                                |
 | **Styling**              | Tailwind CSS with shadcn/ui components                                                                                                                                                                                                                     |
 | **Addons**               | • PWA support<br>• Tauri (desktop applications)<br>• Starlight (documentation site)<br>• Biome (linting and formatting)<br>• Husky (Git hooks)<br>• Turborepo (optimized builds)                                                                           |
@@ -53,7 +53,7 @@ Usage: create-better-t-stack [project-directory] [options]
 Options:
   -V, --version                   Output the version number
   -y, --yes                       Use default configuration
-  --database <type>               Database type (none, sqlite, postgres, mysql, mongodb)
+  --database <type>               Database type (none, sqlite, postgres, mysql, mongodb, singlestore)
   --orm <type>                    ORM type (none, drizzle, prisma, mongoose)
   --auth                          Include authentication
   --no-auth                       Exclude authentication
@@ -65,7 +65,7 @@ Options:
   --package-manager <pm>          Package manager (npm, pnpm, bun)
   --install                       Install dependencies
   --no-install                    Skip installing dependencies
-  --db-setup <setup>              Database setup (turso, d1, neon, supabase, prisma-postgres, mongodb-atlas, docker, none)
+  --db-setup <setup>              Database setup (turso, d1, neon, supabase, prisma-postgres, mongodb-atlas, singlestore-helios, docker, none)
   --web-deploy <setup>            Web deployment (workers, none)
   --backend <framework>           Backend framework (hono, express, elysia, next, convex, fastify, none)
   --runtime <runtime>             Runtime (bun, node, workers, none)
@@ -173,6 +173,11 @@ Create a Cloudflare Workers project:
 
 ```bash
 npx create-better-t-stack my-app --backend hono --runtime workers --database sqlite --orm drizzle --db-setup d1
+
+Create a SingleStore project with Helios cloud setup:
+
+```bash
+npx create-better-t-stack my-app --backend hono --runtime node --database singlestore --orm drizzle --db-setup singlestore-helios --api trpc
 ```
 
 Create a minimal API-only project:
@@ -191,6 +196,7 @@ npx create-better-t-stack my-app --frontend none --backend hono --api trpc --dat
 - **ORM 'none'**: Can be used when you want to handle database operations manually or use a different ORM.
 - **Runtime 'none'**: Only available with Convex backend or when backend is 'none'.
 - **Cloudflare Workers runtime**: Only compatible with Hono backend, Drizzle ORM (or no ORM), and SQLite database (with D1 setup). Not compatible with MongoDB.
+- **SingleStore database**: Only compatible with Drizzle ORM. Always uses SingleStore Helios setup (no manual setup option).
 - **Addons 'none'**: Skips all addons (PWA, Tauri, Starlight, Biome, Husky, Turborepo).
 - **Examples 'none'**: Skips all example implementations (todo, AI chat).
 - **SvelteKit, Nuxt, and SolidJS** frontends are only compatible with oRPC API layer

apps/cli/src/helpers/database-providers/singlestore-helios-setup.ts

@@ -0,0 +1,83 @@
+import path from "node:path";
+import { log } from "@clack/prompts";
+import fs from "fs-extra";
+import pc from "picocolors";
+import type { ProjectConfig } from "../../types";
+import {
+	addEnvVariablesToFile,
+	type EnvVariable,
+} from "../project-generation/env-setup";
+
+type SingleStoreHeliosConfig = {
+	connectionString: string;
+};
+
+async function writeEnvFile(
+	projectDir: string,
+	config?: SingleStoreHeliosConfig,
+) {
+	try {
+		const envPath = path.join(projectDir, "apps/server", ".env");
+		const variables: EnvVariable[] = [
+			{
+				key: "DATABASE_URL",
+				value:
+					config?.connectionString ??
+					"singlestore://username:password@host:port/database?ssl={}",
+				condition: true,
+			},
+		];
+		await addEnvVariablesToFile(envPath, variables);
+	} catch (_error) {
+		log.error("Failed to update environment configuration");
+	}
+}
+
+function displayManualSetupInstructions() {
+	log.info(`
+${pc.green("SingleStore Helios Manual Setup Instructions:")}
+
+1. Sign up for SingleStore Cloud at:
+   ${pc.blue("https://www.singlestore.com/cloud")}
+
+2. Create a new workspace from the dashboard
+
+3. Get your connection string from the workspace details:
+   Format: ${pc.dim("singlestore://USERNAME:PASSWORD@HOST:PORT/DATABASE?ssl={}")}
+
+4. Add the connection string to your .env file:
+   ${pc.dim('DATABASE_URL="your_connection_string"')}
+
+${pc.yellow("Important:")}
+- The connection string MUST include ${pc.bold("ssl={}")} at the end
+- Use the singlestore:// protocol for SingleStore connections
+- SingleStore requires SSL connections for cloud deployments`);
+}
+
+export async function setupSingleStoreHelios(config: ProjectConfig) {
+	const { projectDir } = config;
+
+	try {
+		const serverDir = path.join(projectDir, "apps/server");
+		await fs.ensureDir(serverDir);
+		await writeEnvFile(projectDir);
+
+		log.success(
+			pc.green(
+				"SingleStore Helios setup complete! Please update the connection string in .env file.",
+			),
+		);
+
+		displayManualSetupInstructions();
+	} catch (error) {
+		log.error(pc.red("SingleStore Helios setup failed"));
+		if (error instanceof Error) {
+			log.error(pc.red(error.message));
+		}
+
+		try {
+			await writeEnvFile(projectDir);
+			displayManualSetupInstructions();
+		} catch {}
+	}
+}

apps/cli/src/helpers/project-generation/env-setup.ts

@@ -185,6 +185,7 @@ export async function setupEnvironmentVariables(config: ProjectConfig) {
 		dbSetup === "mongodb-atlas" ||
 		dbSetup === "neon" ||
 		dbSetup === "supabase" ||
+		dbSetup === "singlestore-helios" ||
 		dbSetup === "d1" ||
 		dbSetup === "docker";
 

apps/cli/src/helpers/setup/db-setup.ts

@@ -10,6 +10,7 @@ import { setupDockerCompose } from "../database-providers/docker-compose-setup";
 import { setupMongoDBAtlas } from "../database-providers/mongodb-atlas-setup";
 import { setupNeonPostgres } from "../database-providers/neon-setup";
 import { setupPrismaPostgres } from "../database-providers/prisma-postgres-setup";
+import { setupSingleStoreHelios } from "../database-providers/singlestore-helios-setup";
 import { setupSupabase } from "../database-providers/supabase-setup";
 import { setupTurso } from "../database-providers/turso-setup";
 
@@ -68,6 +69,12 @@ export async function setupDatabase(config: ProjectConfig) {
 					devDependencies: ["drizzle-kit"],
 					projectDir: serverDir,
 				});
+			} else if (database === "singlestore") {
+				await addPackageDependency({
+					dependencies: ["drizzle-orm", "mysql2"],
+					devDependencies: ["drizzle-kit"],
+					projectDir: serverDir,
+				});
 			}
 		} else if (orm === "mongoose") {
 			await addPackageDependency({
@@ -93,6 +100,8 @@ export async function setupDatabase(config: ProjectConfig) {
 			}
 		} else if (database === "mongodb" && dbSetup === "mongodb-atlas") {
 			await setupMongoDBAtlas(config);
+		} else if (database === "singlestore" && dbSetup === "singlestore-helios") {
+			await setupSingleStoreHelios(config);
 		}
 	} catch (error) {
 		s.stop(pc.red("Failed to set up database"));

apps/cli/src/prompts/database-setup.ts

@@ -91,6 +91,8 @@ export async function getDBSetupChoice(
 			},
 			{ value: "none" as const, label: "None", hint: "Manual setup" },
 		];
+	} else if (databaseType === "singlestore") {
+		return "singlestore-helios";
 	} else {
 		return "none";
 	}

apps/cli/src/prompts/database.ts

@@ -47,6 +47,11 @@ export async function getDatabaseChoice(
 			label: "MongoDB",
 			hint: "open-source NoSQL database that stores data in JSON-like documents called BSON",
 		});
+		databaseOptions.push({
+			value: "singlestore",
+			label: "SingleStore",
+			hint: "high-performance distributed SQL database for real-time analytics",
+		});
 	}
 
 	const response = await select<Database>({

apps/cli/src/types.ts

@@ -1,7 +1,7 @@
 import z from "zod";
 
 export const DatabaseSchema = z
-	.enum(["none", "sqlite", "postgres", "mysql", "mongodb"])
+	.enum(["none", "sqlite", "postgres", "mysql", "mongodb", "singlestore"])
 	.describe("Database type");
 export type Database = z.infer<typeof DatabaseSchema>;
 
@@ -70,6 +70,7 @@ export const DatabaseSetupSchema = z
 		"prisma-postgres",
 		"mongodb-atlas",
 		"supabase",
+		"singlestore-helios",
 		"d1",
 		"docker",
 		"none",

apps/cli/src/utils/compatibility-rules.ts

@@ -129,6 +129,64 @@ export function validateWorkersCompatibility(
 			"Docker setup (--db-setup docker) is not compatible with Cloudflare Workers runtime. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.",
 		);
 	}
+
+	if (
+		providedFlags.has("runtime") &&
+		options.runtime === "workers" &&
+		config.database === "singlestore"
+	) {
+		exitWithError(
+			"SingleStore is not supported on Cloudflare Workers. Use Bun or Node.js runtimes.",
+		);
+	}
+
+	if (
+		providedFlags.has("database") &&
+		config.database === "singlestore" &&
+		config.runtime === "workers"
+	) {
+		exitWithError(
+			"SingleStore is not supported on Cloudflare Workers. Use Bun or Node.js runtimes.",
+		);
+	}
+}
+
+export function validateSingleStoreCompatibility(
+	providedFlags: Set<string>,
+	options: CLIInput,
+	config: Partial<ProjectConfig>,
+) {
+	if (
+		providedFlags.has("database") &&
+		options.database === "singlestore" &&
+		config.orm &&
+		config.orm !== "drizzle"
+	) {
+		exitWithError(
+			`SingleStore database requires Drizzle ORM. Current ORM: ${config.orm}. Please use '--orm drizzle' or choose a different database.`,
+		);
+	}
+
+	if (
+		providedFlags.has("orm") &&
+		config.orm &&
+		config.orm !== "drizzle" &&
+		config.database === "singlestore"
+	) {
+		exitWithError(
+			`ORM '${config.orm}' is not compatible with SingleStore database. SingleStore requires Drizzle ORM. Please use '--orm drizzle' or choose a different database.`,
+		);
+	}
+
+	if (
+		providedFlags.has("dbSetup") &&
+		options.dbSetup === "singlestore-helios" &&
+		config.database !== "singlestore"
+	) {
+		exitWithError(
+			`SingleStore Helios setup (--db-setup singlestore-helios) requires SingleStore database. Current database: ${config.database}. Please use '--database singlestore' or choose a different database setup.`,
+		);
+	}
 }
 
 export function coerceBackendPresets(config: Partial<ProjectConfig>) {

apps/cli/src/validation.ts

@@ -20,6 +20,7 @@ import {
 	validateAddonsAgainstFrontends,
 	validateApiFrontendCompatibility,
 	validateExamplesCompatibility,
+	validateSingleStoreCompatibility,
 	validateWebDeployRequiresWebFrontend,
 	validateWorkersCompatibility,
 } from "./utils/compatibility-rules";
@@ -247,6 +248,18 @@ export function processAndValidateFlags(
 		);
 	}
 
+	if (
+		providedFlags.has("database") &&
+		providedFlags.has("orm") &&
+		config.database === "singlestore" &&
+		config.orm &&
+		config.orm !== "drizzle"
+	) {
+		exitWithError(
+			"SingleStore database requires Drizzle ORM. Please use '--orm drizzle' or choose a different database.",
+		);
+	}
+
 	if (
 		providedFlags.has("database") &&
 		providedFlags.has("orm") &&
@@ -349,6 +362,28 @@ export function processAndValidateFlags(
 		);
 	}
 
+	if (
+		providedFlags.has("dbSetup") &&
+		(config.database ? providedFlags.has("database") : true) &&
+		config.dbSetup === "singlestore-helios" &&
+		config.database !== "singlestore"
+	) {
+		exitWithError(
+			"SingleStore Helios setup requires SingleStore database. Please use '--database singlestore' or choose a different setup.",
+		);
+	}
+
+	if (
+		providedFlags.has("database") &&
+		providedFlags.has("dbSetup") &&
+		config.database === "singlestore" &&
+		config.dbSetup === "none"
+	) {
+		exitWithError(
+			"SingleStore database requires SingleStore Helios setup. Please use '--db-setup singlestore-helios' or omit the --db-setup flag.",
+		);
+	}
+
 	if (config.dbSetup === "d1") {
 		if (
 			(providedFlags.has("dbSetup") && providedFlags.has("database")) ||
@@ -396,6 +431,7 @@ export function processAndValidateFlags(
 	}
 
 	validateWorkersCompatibility(providedFlags, options, config);
+	validateSingleStoreCompatibility(providedFlags, options, config);
 
 	const hasWebFrontendFlag = (config.frontend ?? []).some((f) =>
 		isWebFrontend(f),

apps/cli/templates/db/drizzle/singlestore/drizzle.config.ts.hbs

@@ -0,0 +1,10 @@
+import { defineConfig } from "drizzle-kit";
+
+export default defineConfig({
+  schema: "./src/db/schema",
+  out: "./src/db/migrations",
+  dialect: "singlestore",
+  dbCredentials: {
+    url: process.env.DATABASE_URL || "",
+  },
+});

apps/cli/templates/db/drizzle/singlestore/src/db/index.ts.hbs

@@ -0,0 +1,6 @@
+import mysql from "mysql2/promise";
+import { drizzle } from "drizzle-orm/singlestore";
+
+const pool = mysql.createPool(process.env.DATABASE_URL || "");
+
+export const db = drizzle({ client: pool });

apps/cli/templates/examples/todo/server/drizzle/singlestore/src/db/schema/todo.ts

@@ -0,0 +1,7 @@
+import { singlestoreTable, varchar, bigint, boolean } from "drizzle-orm/singlestore-core";
+
+export const todo = singlestoreTable("todo", {
+  id: bigint("id", { mode: "number" }).primaryKey().autoincrement(),
+  text: varchar("text", { length: 255 }).notNull(),
+  completed: boolean("completed").default(false).notNull(),
+});