feat: add centralized TypeScript configuration package (#2096)

Author: stanleynue

apps/api/Dockerfile

@@ -22,8 +22,9 @@ COPY ./apps/api/package.json ./package.json
 # Workspace dependencies like "workspace:*" or "workspace:^1.0.0" cannot be resolved
 # inside Docker since the workspace packages aren't available in the container context.
 # This jq command filters out any dependency where the version starts with "workspace:"
-# Example: "core": "workspace:*" gets removed, "zod": "4.0.5" remains
-RUN jq '.dependencies |= with_entries(select(.value | startswith("workspace:") | not))' \
+# from both dependencies and devDependencies sections
+RUN jq '.dependencies |= with_entries(select(.value | startswith("workspace:") | not)) | \
+    .devDependencies |= with_entries(select(.value | startswith("workspace:") | not))' \
     package.json > package.tmp.json && \
     mv package.tmp.json package.json
 

apps/api/index.ts

@@ -24,6 +24,28 @@ const appRouter = router({
 // HTTP router
 const app = new Hono<AppContext>();
 
+// Root endpoint with API information
+app.get("/", (c) => {
+  return c.json({
+    name: "@repo/api",
+    version: "0.0.0",
+    endpoints: {
+      trpc: "/api/trpc",
+      auth: "/api/auth",
+      health: "/health",
+    },
+    documentation: {
+      trpc: "https://trpc.io",
+      auth: "https://www.better-auth.com",
+    },
+  });
+});
+
+// Health check endpoint
+app.get("/health", (c) => {
+  return c.json({ status: "healthy", timestamp: new Date().toISOString() });
+});
+
 /*
  * Middleware for initializing database and authentication services.
  *

apps/api/package.json

@@ -9,32 +9,33 @@
     "./package.json": "./package.json"
   },
   "scripts": {
-    "dev": "bun run --env-file ../../.env --env-file ../../.env.local ./start.ts",
+    "dev": "bun run --watch --env-file ../../.env --env-file ../../.env.local ./start.ts",
     "build": "bun build index.ts --outdir dist --target bun",
     "test": "vitest",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^2.0.2",
+    "@ai-sdk/openai": "^2.0.6",
     "@repo/core": "workspace:*",
     "@repo/db": "workspace:*",
     "@trpc/server": "^11.4.4",
-    "ai": "^5.0.2",
+    "ai": "^5.0.8",
     "better-auth": "^1.3.4",
     "dataloader": "^2.2.3",
     "drizzle-orm": "^0.44.4",
     "postgres": "^3.4.7"
   },
   "peerDependencies": {
-    "hono": "^4.8.12",
-    "zod": "^4.0.14"
+    "hono": "^4.9.0",
+    "zod": "^4.0.15"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20250805.0",
+    "@cloudflare/workers-types": "^4.20250807.0",
+    "@repo/typescript-config": "workspace:*",
     "@types/bun": "^1.2.19",
-    "hono": "^4.8.12",
-    "typescript": "~5.8.3",
+    "hono": "^4.9.0",
+    "typescript": "~5.9.2",
     "vitest": "~3.2.4",
-    "zod": "^4.0.14"
+    "zod": "^4.0.15"
   }
 }

apps/api/start.ts

@@ -49,7 +49,7 @@ const app = new Hono<AppContext>();
  * - Provides access to all Cloudflare bindings defined in wrangler.jsonc
  */
 const cf = await getPlatformProxy<CloudflareEnv>({
-  configPath: "../../wrangler.jsonc",
+  configPath: "../edge/wrangler.jsonc",
   persist: true,
 });
 

apps/api/tsconfig.json

@@ -1,11 +1,9 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "../../packages/typescript-config/node.jsonc",
   "compilerOptions": {
     "composite": true,
     "declaration": true,
     "declarationMap": true,
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
     "noEmit": false,
     "outDir": "./dist",
     "types": ["@cloudflare/workers-types", "bun"]

apps/edge/package.json

@@ -17,22 +17,23 @@
     "@repo/db": "workspace:*",
     "@trpc/server": "^11.4.4",
     "better-auth": "^1.3.4",
-    "hono": "^4.8.12",
-    "zod": "^4.0.14"
+    "hono": "^4.9.0",
+    "zod": "^4.0.15"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20250805.0"
+    "@cloudflare/workers-types": "^4.20250807.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {
       "optional": true
     }
   },
   "devDependencies": {
-    "@cloudflare/vite-plugin": "^1.11.1",
-    "@cloudflare/vitest-pool-workers": "^0.8.60",
-    "@cloudflare/workers-types": "^4.20250805.0",
+    "@cloudflare/vite-plugin": "^1.11.2",
+    "@cloudflare/vitest-pool-workers": "^0.8.61",
+    "@cloudflare/workers-types": "^4.20250807.0",
     "@hono/vite-build": "^1.7.0",
+    "@repo/typescript-config": "workspace:*",
     "@types/bun": "^1.2.19",
     "typescript": "~5.8.3",
     "vite": "~7.0.6",

apps/edge/tsconfig.json

@@ -1,7 +1,9 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "../../packages/typescript-config/cloudflare.jsonc",
   "compilerOptions": {
-    "lib": ["ESNext"],
+    "composite": true,
+    "declaration": true,
+    "noEmit": false,
     "outDir": "./dist",
     "types": ["@cloudflare/workers-types", "vite/client"]
   },

apps/web/package.json

@@ -29,15 +29,16 @@
     "jotai": "^2.13.0",
     "jotai-effect": "^2.0.5",
     "localforage": "^1.10.0",
-    "lucide-react": "^0.535.0",
+    "lucide-react": "^0.536.0",
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
     "tailwind-merge": "^3.3.1"
   },
   "devDependencies": {
+    "@repo/typescript-config": "workspace:*",
     "@tailwindcss/postcss": "^4.1.11",
     "@tanstack/router-devtools": "^1.130.13",
-    "@tanstack/router-plugin": "^1.130.15",
+    "@tanstack/router-plugin": "^1.130.16",
     "@types/bun": "^1.2.19",
     "@types/node": "^24.2.0",
     "@types/react": "^19.1.9",
@@ -52,8 +53,9 @@
     "postcss": "^8.5.6",
     "tailwindcss": "^4.1.11",
     "tw-animate-css": "^1.3.6",
-    "typescript": "~5.8.3",
-    "vite": "~7.0.6",
+    "typescript": "~5.9.2",
+    "vite": "~7.1.1",
+    "vite-tsconfig-paths": "^5.1.4",
     "vitest": "~3.2.4"
   }
 }

apps/web/tsconfig.json

@@ -1,16 +1,11 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "../../packages/typescript-config/react.jsonc",
   "compilerOptions": {
-    "lib": ["DOM", "DOM.Iterable", "ESNext"],
-    "jsx": "react-jsx",
-    "jsxImportSource": "react",
-    "types": ["vite/client"],
-    "outDir": "../../.cache/ts-app",
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["./*"]
-    }
+    "composite": true,
+    "noEmit": true,
+    "tsBuildInfoFile": "../../.cache/tsconfig/web.tsbuildinfo"
   },
   "include": ["**/*.ts", "**/*.tsx", "**/*.json", "./global.d.ts"],
-  "exclude": ["**/dist/**/*", "**/node_modules/**/*", "lib/routeTree.gen.ts"]
+  "exclude": ["**/dist/**/*", "**/node_modules/**/*"],
+  "references": [{ "path": "../api" }]
 }

apps/web/vite.config.ts

@@ -5,6 +5,7 @@ import { tanstackRouter } from "@tanstack/router-plugin/vite";
 import react from "@vitejs/plugin-react-swc";
 import { URL, fileURLToPath } from "node:url";
 import { loadEnv } from "vite";
+import tsconfigPaths from "vite-tsconfig-paths";
 import { defineProject } from "vitest/config";
 
 const publicEnvVars = [
@@ -49,16 +50,14 @@ export default defineProject(({ mode }) => {
 
     resolve: {
       conditions: ["module", "browser", "development|production"],
-      alias: {
-        "@": fileURLToPath(new URL(".", import.meta.url)),
-      },
     },
 
     css: {
       postcss: "./postcss.config.js",
     },
 
     plugins: [
+      tsconfigPaths(),
       tanstackRouter({
         routesDirectory: "./routes",
         generatedRouteTree: "./lib/routeTree.gen.ts",