feat(cli): add typescript config internal package(#661)

moreorover · AmanVarshney01 · web-flow · commit 468813f3ed0f · 2025-11-11T01:47:18.000+05:30
Co-authored-by: Aman Varshney &lt;amanvarshney.work@gmail.com&gt;
diff --git a/apps/cli/src/helpers/core/template-manager.ts b/apps/cli/src/helpers/core/template-manager.ts
@@ -275,6 +275,16 @@ async function setupApiPackage(projectDir: string, context: ProjectConfig) {
 	}
 }
 
+async function setupConfigPackage(projectDir: string, context: ProjectConfig) {
+	const configPackageDir = path.join(projectDir, "packages/config");
+	await fs.ensureDir(configPackageDir);
+
+	const configBaseDir = path.join(PKG_ROOT, "templates/packages/config");
+	if (await fs.pathExists(configBaseDir)) {
+		await processAndCopyFiles("**/*", configBaseDir, configPackageDir, context);
+	}
+}
+
 async function setupDbPackage(projectDir: string, context: ProjectConfig) {
 	if (context.database === "none" || context.orm === "none") return;
 
@@ -345,6 +355,8 @@ export async function setupBackendFramework(
 	projectDir: string,
 	context: ProjectConfig,
 ) {
+	await setupConfigPackage(projectDir, context);
+
 	if (context.backend === "none") {
 		return;
 	}
diff --git a/apps/cli/src/helpers/core/workspace-setup.ts b/apps/cli/src/helpers/core/workspace-setup.ts
@@ -15,11 +15,18 @@ export async function setupWorkspaceDependencies(
 	const commonDeps: AvailableDependencies[] = ["dotenv", "zod"];
 	const commonDevDeps: AvailableDependencies[] = ["tsdown"];
 
+	const configPackageDir = path.join(projectDir, "packages/config");
+	const configDep: Record<string, string> = {};
+	if (await fs.pathExists(configPackageDir)) {
+		configDep[`@${projectName}/config`] = workspaceVersion;
+	}
+
 	const dbPackageDir = path.join(projectDir, "packages/db");
 	if (await fs.pathExists(dbPackageDir)) {
 		await addPackageDependency({
 			dependencies: commonDeps,
 			devDependencies: commonDevDeps,
+			customDevDependencies: configDep,
 			projectDir: dbPackageDir,
 		});
 	}
@@ -35,6 +42,7 @@ export async function setupWorkspaceDependencies(
 			dependencies: commonDeps,
 			devDependencies: commonDevDeps,
 			customDependencies: authDeps,
+			customDevDependencies: configDep,
 			projectDir: authPackageDir,
 		});
 	}
@@ -53,6 +61,7 @@ export async function setupWorkspaceDependencies(
 			dependencies: commonDeps,
 			devDependencies: commonDevDeps,
 			customDependencies: apiDeps,
+			customDevDependencies: configDep,
 			projectDir: apiPackageDir,
 		});
 	}
@@ -74,6 +83,7 @@ export async function setupWorkspaceDependencies(
 			dependencies: commonDeps,
 			devDependencies: commonDevDeps,
 			customDependencies: serverDeps,
+			customDevDependencies: configDep,
 			projectDir: serverPackageDir,
 		});
 	}
@@ -92,6 +102,7 @@ export async function setupWorkspaceDependencies(
 		if (Object.keys(webDeps).length > 0) {
 			await addPackageDependency({
 				customDependencies: webDeps,
+				customDevDependencies: configDep,
 				projectDir: webPackageDir,
 			});
 		}
@@ -108,6 +119,7 @@ export async function setupWorkspaceDependencies(
 		if (Object.keys(nativeDeps).length > 0) {
 			await addPackageDependency({
 				customDependencies: nativeDeps,
+				customDevDependencies: configDep,
 				projectDir: nativePackageDir,
 			});
 		}
diff --git a/apps/cli/templates/api/orpc/server/tsconfig.json.hbs b/apps/cli/templates/api/orpc/server/tsconfig.json.hbs
@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "@{{projectName}}/config/tsconfig.base.json",
   "compilerOptions": {
     "declaration": true,
     "declarationMap": true,
diff --git a/apps/cli/templates/api/trpc/server/tsconfig.json.hbs b/apps/cli/templates/api/trpc/server/tsconfig.json.hbs
@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "@{{projectName}}/config/tsconfig.base.json",
   "compilerOptions": {
     "declaration": true,
     "declarationMap": true,
diff --git a/apps/cli/templates/auth/better-auth/server/base/tsconfig.json.hbs b/apps/cli/templates/auth/better-auth/server/base/tsconfig.json.hbs
@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "@{{projectName}}/config/tsconfig.base.json",
   "compilerOptions": {
     "declaration": true,
     "declarationMap": true,
diff --git a/apps/cli/templates/backend/server/base/tsconfig.json.hbs b/apps/cli/templates/backend/server/base/tsconfig.json.hbs
@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "@{{projectName}}/config/tsconfig.base.json",
   "compilerOptions": {
     "composite": true,
 		"outDir": "dist",
diff --git a/apps/cli/templates/base/tsconfig.json.hbs b/apps/cli/templates/base/tsconfig.json.hbs
diff --git a/apps/cli/templates/db/base/tsconfig.json.hbs b/apps/cli/templates/db/base/tsconfig.json.hbs
@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "@{{projectName}}/config/tsconfig.base.json",
   "compilerOptions": {
     "declaration": true,
     "declarationMap": true,
diff --git a/apps/cli/templates/packages/config/package.json.hbs b/apps/cli/templates/packages/config/package.json.hbs
@@ -0,0 +1,5 @@
+{
+  "name": "@{{projectName}}/config",
+  "version": "0.0.0",
+  "private": true
+}
diff --git a/apps/cli/templates/packages/config/tsconfig.base.json.hbs b/apps/cli/templates/packages/config/tsconfig.base.json.hbs
diff --git a/apps/cli/test/config-package.test.ts b/apps/cli/test/config-package.test.ts
@@ -0,0 +1,229 @@
+import { afterAll, beforeAll, describe, it } from "vitest";
+import {
+	cleanupSmokeDirectory,
+	runTRPCTest,
+	validateConfigPackageSetup,
+	validateTurboPrune,
+} from "./test-utils";
+
+describe("Config Package Feature", () => {
+	beforeAll(async () => {
+		await cleanupSmokeDirectory();
+	});
+	afterAll(async () => {
+		await cleanupSmokeDirectory();
+	});
+
+	describe("Basic Stack Configurations", () => {
+		it("should validate hono + pnpm + turbo stack", async () => {
+			const result = await runTRPCTest({
+				projectName: "hono-pnpm",
+				backend: "hono",
+				runtime: "node",
+				packageManager: "pnpm",
+				database: "sqlite",
+				orm: "drizzle",
+				api: "trpc",
+				frontend: ["tanstack-router"],
+				addons: ["turborepo"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+			await validateTurboPrune(result);
+		});
+
+		it("should validate hono + pnpm + turbo + wrangler stack", async () => {
+			const result = await runTRPCTest({
+				projectName: "hono-pnpm-turbo-wrangler",
+				backend: "hono",
+				runtime: "workers",
+				packageManager: "pnpm",
+				database: "sqlite",
+				orm: "drizzle",
+				api: "trpc",
+				frontend: ["tanstack-router"],
+				addons: ["turborepo"],
+				serverDeploy: "wrangler",
+				webDeploy: "wrangler",
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+			await validateTurboPrune(result);
+		});
+
+		it("should validate hono + node stack", async () => {
+			const result = await runTRPCTest({
+				projectName: "hono-node",
+				backend: "hono",
+				runtime: "node",
+				database: "sqlite",
+				orm: "drizzle",
+				api: "trpc",
+				frontend: ["tanstack-router"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+		});
+
+		it("should validate hono + bun stack", async () => {
+			const result = await runTRPCTest({
+				projectName: "hono-bun",
+				backend: "hono",
+				runtime: "bun",
+				database: "sqlite",
+				orm: "drizzle",
+				api: "trpc",
+				frontend: ["tanstack-router"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+		});
+
+		it("should validate express + node stack", async () => {
+			const result = await runTRPCTest({
+				projectName: "express-node",
+				backend: "express",
+				runtime: "node",
+				database: "sqlite",
+				orm: "drizzle",
+				frontend: ["tanstack-router"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+		});
+
+		it("should validate fastify + node stack", async () => {
+			const result = await runTRPCTest({
+				projectName: "fastify-node",
+				backend: "fastify",
+				runtime: "node",
+				frontend: ["tanstack-router"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+		});
+	});
+
+	describe("Full Stack with Authentication", () => {
+		it("should validate full stack with better-auth", async () => {
+			const result = await runTRPCTest({
+				projectName: "full-stack-auth",
+				backend: "hono",
+				runtime: "node",
+				database: "postgres",
+				orm: "drizzle",
+				api: "trpc",
+				auth: "better-auth",
+				frontend: ["tanstack-router"],
+				addons: ["turborepo"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+			await validateTurboPrune(result);
+		});
+	});
+
+	describe("API Variants", () => {
+		it("should validate stack with tRPC", async () => {
+			const result = await runTRPCTest({
+				projectName: "trpc-api",
+				backend: "hono",
+				runtime: "node",
+				api: "trpc",
+				database: "sqlite",
+				orm: "drizzle",
+				frontend: ["tanstack-router"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+		});
+
+		it("should validate stack with oRPC", async () => {
+			const result = await runTRPCTest({
+				projectName: "orpc-api",
+				backend: "hono",
+				runtime: "node",
+				api: "orpc",
+				database: "sqlite",
+				orm: "drizzle",
+				frontend: ["tanstack-router"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+		});
+	});
+
+	describe("Edge Cases", () => {
+		it("should validate frontend-only stack (no backend)", async () => {
+			const result = await runTRPCTest({
+				projectName: "frontend-only",
+				backend: "none",
+				runtime: "none",
+				database: "none",
+				orm: "none",
+				api: "none",
+				auth: "none",
+				frontend: ["tanstack-router"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+		});
+
+		it("should validate convex backend", async () => {
+			const result = await runTRPCTest({
+				projectName: "convex-backend",
+				backend: "convex",
+				runtime: "none",
+				database: "none",
+				orm: "none",
+				api: "none",
+				frontend: ["next"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+		});
+
+		it("should validate self-hosted backend", async () => {
+			const result = await runTRPCTest({
+				projectName: "self-backend",
+				backend: "self",
+				runtime: "none",
+				api: "trpc",
+				database: "sqlite",
+				orm: "drizzle",
+				frontend: ["next"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+		});
+
+		it("should validate stack without database", async () => {
+			const result = await runTRPCTest({
+				projectName: "no-database",
+				backend: "hono",
+				runtime: "node",
+				database: "none",
+				orm: "none",
+				api: "trpc",
+				frontend: ["tanstack-router"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+		});
+
+		it("should validate stack with turborepo addon", async () => {
+			const result = await runTRPCTest({
+				projectName: "with-turborepo",
+				backend: "hono",
+				runtime: "node",
+				database: "sqlite",
+				orm: "drizzle",
+				frontend: ["tanstack-router"],
+				addons: ["turborepo"],
+				install: false,
+			});
+			await validateConfigPackageSetup(result);
+			await validateTurboPrune(result);
+		});
+	});
+});
diff --git a/apps/cli/test/test-utils.ts b/apps/cli/test/test-utils.ts

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "extends": "../../tsconfig.base.json",`
	`2`	`+ "extends": "@{{projectName}}/config/tsconfig.base.json",`
`3`	`3`	`"compilerOptions": {`
`4`	`4`	`"declaration": true,`
`5`	`5`	`"declarationMap": true,`