create-better-t-stack 2.40.3 → 2.40.5

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createBtsCli } from "./src-BOnnM-3r.js";
+import { createBtsCli } from "./src-jRwaAdo-.js";
 
 //#region src/cli.ts
 createBtsCli().run();

package/dist/index.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { builder, createBtsCli, docs, init, router, sponsors } from "./src-BOnnM-3r.js";
+import { builder, createBtsCli, docs, init, router, sponsors } from "./src-jRwaAdo-.js";
 
 export { builder, createBtsCli, docs, init, router, sponsors };

package/dist/{src-BOnnM-3r.js → src-jRwaAdo-.js}

@@ -110,6 +110,8 @@ const dependencyVersionMap = {
 	streamdown: "^1.1.6",
 	"@orpc/server": "^1.8.6",
 	"@orpc/client": "^1.8.6",
+	"@orpc/openapi": "^1.8.6",
+	"@orpc/zod": "^1.8.6",
 	"@orpc/tanstack-query": "^1.8.6",
 	"@trpc/tanstack-react-query": "^11.5.0",
 	"@trpc/server": "^11.5.0",
@@ -3096,8 +3098,7 @@ async function setupNextAlchemyDeploy(projectDir, _packageManager, options) {
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3122,8 +3123,7 @@ async function setupNuxtAlchemyDeploy(projectDir, _packageManager, options) {
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3186,8 +3186,7 @@ async function setupReactRouterAlchemyDeploy(projectDir, _packageManager, option
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3208,8 +3207,7 @@ async function setupSolidAlchemyDeploy(projectDir, _packageManager, options) {
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3234,8 +3232,7 @@ async function setupSvelteAlchemyDeploy(projectDir, _packageManager, options) {
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3301,8 +3298,7 @@ async function setupTanStackRouterAlchemyDeploy(projectDir, _packageManager, opt
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3327,8 +3323,7 @@ async function setupTanStackStartAlchemyDeploy(projectDir, _packageManager, opti
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3892,7 +3887,12 @@ function getFrontendType(frontend) {
 }
 function getApiDependencies(api, frontendType) {
 	const deps = {};
-	if (api === "orpc") deps.server = { dependencies: ["@orpc/server", "@orpc/client"] };
+	if (api === "orpc") deps.server = { dependencies: [
+		"@orpc/server",
+		"@orpc/client",
+		"@orpc/openapi",
+		"@orpc/zod"
+	] };
 	else if (api === "trpc") deps.server = { dependencies: ["@trpc/server", "@trpc/client"] };
 	if (frontendType.hasReactWeb) {
 		if (api === "orpc") deps.web = { dependencies: ["@orpc/tanstack-query", "@orpc/client"] };
@@ -5740,7 +5740,7 @@ async function getDockerStatus(database) {
 //#endregion
 //#region src/helpers/core/post-installation.ts
 async function displayPostInstallInstructions(config) {
-	const { database, relativePath, packageManager, depsInstalled, orm, addons, runtime, frontend, backend, dbSetup, webDeploy, serverDeploy } = config;
+	const { api, database, relativePath, packageManager, depsInstalled, orm, addons, runtime, frontend, backend, dbSetup, webDeploy, serverDeploy } = config;
 	const isConvex = backend === "convex";
 	const runCmd = packageManager === "npm" ? "npm run" : packageManager === "pnpm" ? "pnpm run" : "bun run";
 	const cdCmd = `cd ${relativePath}`;
@@ -5788,7 +5788,11 @@ async function displayPostInstallInstructions(config) {
 	output += `${pc.bold("Your project will be available at:")}\n`;
 	if (hasWeb) output += `${pc.cyan("•")} Frontend: http://localhost:${webPort}\n`;
 	else if (!hasNative && !addons?.includes("starlight")) output += `${pc.yellow("NOTE:")} You are creating a backend-only app\n   (no frontend selected)\n`;
-	if (!isConvex) output += `${pc.cyan("•")} Backend API: http://localhost:3000\n`;
+	if (!isConvex) {
+		output += `${pc.cyan("•")} Backend API: http://localhost:3000\n`;
+		if (api === "orpc") if (backend === "next") output += `${pc.cyan("•")} OpenAPI (Scalar UI): http://localhost:3000/rpc/api\n`;
+		else output += `${pc.cyan("•")} OpenAPI (Scalar UI): http://localhost:3000/api\n`;
+	}
 	if (addons?.includes("starlight")) output += `${pc.cyan("•")} Docs: http://localhost:4321\n`;
 	if (addons?.includes("fumadocs")) output += `${pc.cyan("•")} Fumadocs: http://localhost:4000\n`;
 	if (nativeInstructions) output += `\n${nativeInstructions.trim()}\n`;
@@ -6365,7 +6369,7 @@ async function openUrl(url) {
 
 //#endregion
 //#region src/utils/sponsors.ts
-const SPONSORS_JSON_URL = "https://sponsors.amanv.dev/sponsors.json";
+const SPONSORS_JSON_URL = "https://sponsors.better-t-stack.dev/sponsors.json";
 async function fetchSponsors(url = SPONSORS_JSON_URL) {
 	const s = spinner();
 	s.start("Fetching sponsors…");
@@ -6379,23 +6383,30 @@ async function fetchSponsors(url = SPONSORS_JSON_URL) {
 	return sponsors$1;
 }
 function displaySponsors(sponsors$1) {
-	if (sponsors$1.length === 0) {
+	const { total_sponsors } = sponsors$1.summary;
+	if (total_sponsors === 0) {
 		log.info("No sponsors found. You can be the first one! ✨");
 		outro(pc.cyan("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
 		return;
 	}
-	sponsors$1.forEach((entry, idx) => {
-		const sponsor = entry.sponsor;
-		const displayName = sponsor.name ?? sponsor.login;
-		const tier = entry.tierName ? ` (${entry.tierName})` : "";
-		log.step(`${idx + 1}. ${pc.green(displayName)}${pc.yellow(tier)}`);
-		log.message(`   ${pc.dim("GitHub:")} https://github.com/${sponsor.login}`);
-		const website = sponsor.websiteUrl ?? sponsor.linkUrl;
-		if (website) log.message(`   ${pc.dim("Website:")} ${website}`);
-	});
-	log.message("");
+	displaySponsorsBox(sponsors$1);
+	if (total_sponsors - sponsors$1.specialSponsors.length > 0) log.message(pc.blue(`+${total_sponsors - sponsors$1.specialSponsors.length} more amazing sponsors.\n`));
 	outro(pc.magenta("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
 }
+function displaySponsorsBox(sponsors$1) {
+	if (sponsors$1.specialSponsors.length === 0) return;
+	let output = `${pc.bold(pc.cyan("-> Special Sponsors"))}\n\n`;
+	sponsors$1.specialSponsors.forEach((sponsor, idx) => {
+		const displayName = sponsor.name ?? sponsor.githubId;
+		const tier = sponsor.tierName ? ` ${pc.yellow(`(${sponsor.tierName})`)}` : "";
+		output += `${pc.green(`• ${displayName}`)}${tier}\n`;
+		output += `  ${pc.dim("GitHub:")} https://github.com/${sponsor.githubId}\n`;
+		const website = sponsor.websiteUrl ?? sponsor.githubUrl;
+		if (website) output += `  ${pc.dim("Website:")} ${website}\n`;
+		if (idx < sponsors$1.specialSponsors.length - 1) output += "\n";
+	});
+	consola$1.box(output);
+}
 
 //#endregion
 //#region src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "2.40.3",
+  "version": "2.40.5",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
   "type": "module",
   "license": "MIT",

package/templates/api/orpc/server/next/src/app/rpc/[...all]/route.ts.hbs

@@ -2,18 +2,47 @@
 import { createContext } from '@/lib/context'
 {{/if}}
 import { appRouter } from '@/routers'
+import { OpenAPIHandler } from '@orpc/openapi/fetch'
+import { OpenAPIReferencePlugin } from '@orpc/openapi/plugins'
+import { ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
 import { RPCHandler } from '@orpc/server/fetch'
+import { onError } from '@orpc/server'
 import { NextRequest } from 'next/server'
 
-const handler = new RPCHandler(appRouter)
+const rpcHandler = new RPCHandler(appRouter, {
+  interceptors: [
+    onError((error) => {
+      console.error(error)
+    }),
+  ],
+})
+const apiHandler = new OpenAPIHandler(appRouter, {
+  plugins: [
+    new OpenAPIReferencePlugin({
+      schemaConverters: [new ZodToJsonSchemaConverter()],
+    }),
+  ],
+  interceptors: [
+    onError((error) => {
+      console.error(error)
+    }),
+  ],
+})
 
 async function handleRequest(req: NextRequest) {
-  const { response } = await handler.handle(req, {
+  const rpcResult = await rpcHandler.handle(req, {
     prefix: '/rpc',
     context: {{#if (eq auth "better-auth")}}await createContext(req){{else}}{}{{/if}},
   })
+  if (rpcResult.response) return rpcResult.response
 
-  return response ?? new Response('Not found', { status: 404 })
+  const apiResult = await apiHandler.handle(req, {
+    prefix: '/rpc/api',
+    context: {{#if (eq auth "better-auth")}}await createContext(req){{else}}{}{{/if}},
+  })
+  if (apiResult.response) return apiResult.response
+
+  return new Response('Not found', { status: 404 })
 }
 
 export const GET = handleRequest

package/templates/backend/server/elysia/src/index.ts.hbs

@@ -10,7 +10,11 @@ import { appRouter } from "./routers/index";
 import { fetchRequestHandler } from "@trpc/server/adapters/fetch";
 {{/if}}
 {{#if (eq api "orpc")}}
+import { OpenAPIHandler } from "@orpc/openapi/fetch";
+import { OpenAPIReferencePlugin } from "@orpc/openapi/plugins";
+import { ZodToJsonSchemaConverter } from "@orpc/zod/zod4";
 import { RPCHandler } from "@orpc/server/fetch";
+import { onError } from "@orpc/server";
 import { appRouter } from "./routers";
 import { createContext } from "./lib/context";
 {{/if}}
@@ -19,7 +23,25 @@ import { auth } from "./lib/auth";
 {{/if}}
 
 {{#if (eq api "orpc")}}
-const handler = new RPCHandler(appRouter);
+const rpcHandler = new RPCHandler(appRouter, {
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+const apiHandler = new OpenAPIHandler(appRouter, {
+  plugins: [
+    new OpenAPIReferencePlugin({
+      schemaConverters: [new ZodToJsonSchemaConverter()],
+    }),
+  ],
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
 {{/if}}
 
 {{#if (eq runtime "node")}}
@@ -48,12 +70,19 @@ const app = new Elysia()
   {{/if}}
 {{#if (eq api "orpc")}}
   .all('/rpc*', async (context) => {
-    const { response } = await handler.handle(context.request, {
+    const { response } = await rpcHandler.handle(context.request, {
       prefix: '/rpc',
       context: await createContext({ context })
     })
     return response ?? new Response('Not Found', { status: 404 })
   })
+  .all('/api*', async (context) => {
+    const { response } = await apiHandler.handle(context.request, {
+      prefix: '/api',
+      context: await createContext({ context })
+    })
+    return response ?? new Response('Not Found', { status: 404 })
+  })
 {{/if}}
 {{#if (eq api "trpc")}}
   .all("/trpc/*", async (context) => {

package/templates/backend/server/express/src/index.ts.hbs

@@ -5,7 +5,11 @@ import { createContext } from "./lib/context";
 import { appRouter } from "./routers/index";
 {{/if}}
 {{#if (eq api "orpc")}}
+import { OpenAPIHandler } from "@orpc/openapi/node";
+import { OpenAPIReferencePlugin } from "@orpc/openapi/plugins";
+import { ZodToJsonSchemaConverter } from "@orpc/zod/zod4";
 import { RPCHandler } from "@orpc/server/node";
+import { onError } from "@orpc/server";
 import { appRouter } from "./routers";
 {{#if (eq auth "better-auth")}}
 import { createContext } from "./lib/context";
@@ -50,9 +54,28 @@ app.use(
 {{/if}}
 
 {{#if (eq api "orpc")}}
-const handler = new RPCHandler(appRouter);
-app.use("/rpc{*path}", async (req, res, next) => {
-  const { matched } = await handler.handle(req, res, {
+const rpcHandler = new RPCHandler(appRouter, {
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+const apiHandler = new OpenAPIHandler(appRouter, {
+  plugins: [
+    new OpenAPIReferencePlugin({
+      schemaConverters: [new ZodToJsonSchemaConverter()],
+    }),
+  ],
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+
+app.use(async (req, res, next) => {
+  const rpcResult = await rpcHandler.handle(req, res, {
     prefix: "/rpc",
     {{#if (eq auth "better-auth")}}
     context: await createContext({ req }),
@@ -60,7 +83,18 @@ app.use("/rpc{*path}", async (req, res, next) => {
     context: {},
     {{/if}}
   });
-  if (matched) return;
+  if (rpcResult.matched) return;
+
+  const apiResult = await apiHandler.handle(req, res, {
+    prefix: "/api",
+    {{#if (eq auth "better-auth")}}
+    context: await createContext({ req }),
+    {{else}}
+    context: {},
+    {{/if}}
+  });
+  if (apiResult.matched) return;
+
   next();
 });
 {{/if}}

package/templates/backend/server/fastify/src/index.ts.hbs

@@ -9,8 +9,12 @@ import { appRouter, type AppRouter } from "./routers/index";
 {{/if}}
 
 {{#if (eq api "orpc")}}
+import { OpenAPIHandler } from "@orpc/openapi/node";
+import { OpenAPIReferencePlugin } from "@orpc/openapi/plugins";
+import { ZodToJsonSchemaConverter } from "@orpc/zod/zod4";
 import { RPCHandler } from "@orpc/server/node";
 import { CORSPlugin } from "@orpc/server/plugins";
+import { onError } from "@orpc/server";
 import { appRouter } from "./routers/index";
 import { createServer } from "node:http";
 {{#if (eq auth "better-auth")}}
@@ -40,7 +44,7 @@ const baseCorsConfig = {
 };
 
 {{#if (eq api "orpc")}}
-const handler = new RPCHandler(appRouter, {
+const rpcHandler = new RPCHandler(appRouter, {
   plugins: [
     new CORSPlugin({
       origin: process.env.CORS_ORIGIN,
@@ -48,13 +52,31 @@ const handler = new RPCHandler(appRouter, {
       allowHeaders: ["Content-Type", "Authorization"],
     }),
   ],
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+
+const apiHandler = new OpenAPIHandler(appRouter, {
+  plugins: [
+    new OpenAPIReferencePlugin({
+      schemaConverters: [new ZodToJsonSchemaConverter()],
+    }),
+  ],
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
 });
 
 const fastify = Fastify({
   logger: true,
   serverFactory: (fastifyHandler) => {
     const server = createServer(async (req, res) => {
-      const { matched } = await handler.handle(req, res, {
+      const { matched } = await rpcHandler.handle(req, res, {
         context: await createContext(req.headers),
         prefix: "/rpc",
       });
@@ -63,6 +85,15 @@ const fastify = Fastify({
         return;
       }
 
+      const apiResult = await apiHandler.handle(req, res, {
+        context: await createContext(req.headers),
+        prefix: "/api",
+      });
+
+      if (apiResult.matched) {
+        return;
+      }
+
       fastifyHandler(req, res);
     });
 

package/templates/backend/server/hono/src/index.ts.hbs

@@ -5,7 +5,11 @@ import "dotenv/config";
 import { env } from "cloudflare:workers";
 {{/if}}
 {{#if (eq api "orpc")}}
+import { OpenAPIHandler } from "@orpc/openapi/fetch";
+import { OpenAPIReferencePlugin } from "@orpc/openapi/plugins";
+import { ZodToJsonSchemaConverter } from "@orpc/zod/zod4";
 import { RPCHandler } from "@orpc/server/fetch";
+import { onError } from "@orpc/server";
 import { createContext } from "./lib/context";
 import { appRouter } from "./routers/index";
 {{/if}}
@@ -54,17 +58,48 @@ app.on(["POST", "GET"], "/api/auth/**", (c) => auth.handler(c.req.raw));
 {{/if}}
 
 {{#if (eq api "orpc")}}
-const handler = new RPCHandler(appRouter);
-app.use("/rpc/*", async (c, next) => {
+export const apiHandler = new OpenAPIHandler(appRouter, {
+  plugins: [
+    new OpenAPIReferencePlugin({
+      schemaConverters: [new ZodToJsonSchemaConverter()],
+    }),
+  ],
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+
+export const rpcHandler = new RPCHandler(appRouter, {
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+
+app.use("/*", async (c, next) => {
   const context = await createContext({ context: c });
-  const { matched, response } = await handler.handle(c.req.raw, {
+
+  const rpcResult = await rpcHandler.handle(c.req.raw, {
     prefix: "/rpc",
     context: context,
   });
 
-  if (matched) {
-    return c.newResponse(response.body, response);
+  if (rpcResult.matched) {
+    return c.newResponse(rpcResult.response.body, rpcResult.response);
   }
+
+  const apiResult = await apiHandler.handle(c.req.raw, {
+    prefix: "/api",
+    context: context,
+  });
+
+  if (apiResult.matched) {
+    return c.newResponse(apiResult.response.body, apiResult.response);
+  }
+
   await next();
 });
 {{/if}}