feature: create example app

arnaudpfu · arnaudpfu · commit f25108bfd3f2 · 2025-12-11T02:39:37.000+01:00
diff --git a/example/.gitignore b/example/.gitignore
@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
diff --git a/example/README.md b/example/README.md
@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
diff --git a/example/app/api/trpc/[trpc]/route.ts b/example/app/api/trpc/[trpc]/route.ts
@@ -0,0 +1,9 @@
+import { createTrpcAPI } from "../../../../../src/create-trpc-api";
+import { appRouter, createContext } from "~/trpc/router";
+
+const handler = createTrpcAPI({
+  router: appRouter,
+  ctx: createContext,
+});
+
+export { handler as GET, handler as POST };
diff --git a/example/app/client-comp.tsx b/example/app/client-comp.tsx
@@ -0,0 +1,15 @@
+"use client";
+
+import React from "react";
+import { clientTrpc } from "~/trpc/client";
+
+export const ClientComp: React.FC = () => {
+  const user = clientTrpc.getUser.useQuery();
+  console.log({ clientUser: user.data });
+
+  if (user.isLoading) {
+    return <>Loading...</>;
+  }
+
+  return <>{JSON.stringify(user.data)}</>;
+};
diff --git a/example/app/favicon.ico b/example/app/favicon.ico
diff --git a/example/app/globals.css b/example/app/globals.css
@@ -0,0 +1,26 @@
+@import "tailwindcss";
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Arial, Helvetica, sans-serif;
+}
diff --git a/example/app/layout.tsx b/example/app/layout.tsx
@@ -0,0 +1,34 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: "Create Next App",
+  description: "Generated by create next app",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased`}
+      >
+        {children}
+      </body>
+    </html>
+  );
+}
diff --git a/example/app/page.tsx b/example/app/page.tsx
@@ -0,0 +1,17 @@
+"use server";
+
+import { serverTrpc } from "~/trpc/server-client";
+import { ClientComp } from "./client-comp";
+
+export default async function Home() {
+  const user = await serverTrpc.getUser.fetch();
+  console.log({ user });
+
+  return (
+    <div className="flex min-h-screen items-center justify-center bg-zinc-50 font-sans dark:bg-black">
+      <main className="flex min-h-screen w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-white dark:bg-black sm:items-start">
+        <ClientComp />
+      </main>
+    </div>
+  );
+}
diff --git a/example/eslint.config.mjs b/example/eslint.config.mjs
@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;
diff --git a/example/next.config.ts b/example/next.config.ts
@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;
diff --git a/example/package.json b/example/package.json
@@ -0,0 +1,27 @@
+{
+  "name": "example",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "clean": "git clean -xdf .cache .next .turbo build dist node_modules",
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "next": "16.0.8",
+    "react": "19.2.1",
+    "react-dom": "19.2.1"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.0.8",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}
diff --git a/example/postcss.config.mjs b/example/postcss.config.mjs
@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;
diff --git a/example/trpc/client.ts b/example/trpc/client.ts
@@ -0,0 +1,10 @@
+import "client-only";
+
+import { createTrpcQueryClient } from "../../src/create-trpc-query-client";
+import { type AppRouter } from "./router";
+
+const url = "https://localhost:3000/api/trpc";
+
+export const clientTrpc = createTrpcQueryClient<AppRouter>({
+  url,
+});
diff --git a/example/trpc/router.ts b/example/trpc/router.ts
@@ -0,0 +1,60 @@
+import { CtxRouter, endpoint } from "../../src/core";
+import z from "zod";
+
+export const createContext = async () => {
+  return {
+    hello: true,
+    howAreYou: "fine and you?",
+  };
+};
+
+const ctx = new CtxRouter<Awaited<ReturnType<typeof createContext>>>();
+
+export const appRouter = ctx.router({
+  getUser: endpoint.action(async ({ hello, howAreYou, request }) => {
+    console.log({
+      myCustomContext: {
+        hello,
+        howAreYou,
+      },
+      nextjsRequest: request,
+    });
+
+    return new Promise((resolve) => {
+      setTimeout(() => {
+        resolve({
+          id: "1",
+          name: "John Doe",
+          email: "john@example.com",
+          avatar: "https://avatar.example.com/john.jpg",
+        });
+      }, 1000);
+    });
+  }),
+  greeting: endpoint
+  .input(
+      z.object({
+          name: z.string(),
+          age: z.coerce.number(),
+        })
+    )
+    .action(({ name, age }, { howAreYou }) => {
+        console.log({ howAreYou });
+        return `Hi my name is ${name}, and I am ${age} years old.`;
+    }),
+    test: endpoint.action(async ({ hello, howAreYou, request }) => {
+  
+      return new Promise((resolve) => {
+        setTimeout(() => {
+          resolve({
+            id: "1",
+            name: "John Doe",
+            email: "john@example.com",
+            avatar: "https://avatar.example.com/john.jpg",
+          });
+        }, 1000);
+      });
+    }),
+});
+
+export type AppRouter = typeof appRouter;
diff --git a/example/trpc/server-client.ts b/example/trpc/server-client.ts
@@ -0,0 +1,10 @@
+import "server-only";
+
+import { createTrpcClient } from "../../src/create-trpc-client";
+import { AppRouter } from "./router";
+
+const url = "https://localhost:3000/api/trpc";
+
+export const serverTrpc = createTrpcClient<AppRouter>({
+  url,
+});
diff --git a/example/tsconfig.json b/example/tsconfig.json
@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "~/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}
diff --git a/package.json b/package.json
@@ -25,7 +25,7 @@
     ],
     "scripts": {
         "build": "tsc --noEmit false --outDir dist --declaration",
-        "clean": "git clean -xdf .turbo node_modules",
+        "clean": "git clean -xdf .turbo dist node_modules",
         "format": "prettier --check \"**/*.{ts,tsx}\"",
         "lint": "eslint .",
         "typecheck": "tsc --noEmit",
@@ -52,6 +52,7 @@
         }
     },
     "devDependencies": {
+        "turbo": "^2.6.3",
         "typescript": "~5.9.2"
     },
     "peerDependencies": {
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
diff --git a/src/create-trpc-api.ts b/src/create-trpc-api.ts
diff --git a/src/create-trpc-client.ts b/src/create-trpc-client.ts
diff --git a/src/create-trpc-query-client.ts b/src/create-trpc-query-client.ts
diff --git a/turbo.json b/turbo.json
