docs(examples): add Tanstack Start example (#2209)

Author: depsimon

examples/tanstack-start/.gitignore

@@ -0,0 +1,21 @@
+node_modules
+.yarn
+
+.DS_Store
+.cache
+.env
+.vercel
+.output
+.vinxi
+
+/build/
+/api/
+/server/build
+/public/build
+.vinxi
+# Sentry Config File
+.env.sentry-build-plugin
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/

examples/tanstack-start/.prettierignore

@@ -0,0 +1,4 @@
+**/build
+**/public
+pnpm-lock.yaml
+routeTree.gen.ts

examples/tanstack-start/README.md

@@ -0,0 +1,14 @@
+# Example project using Tanstack Start + Vite + Babel with LinguiJS Plugin
+
+This is a [Tanstack Start](https://tanstack.com/start/latest) project that demonstrates i18n support with Lingui.
+
+## Development
+
+From your terminal:
+
+```sh
+yarn install
+yarn dev
+```
+
+This starts your app in development mode, rebuilding assets on file changes.

examples/tanstack-start/app.config.ts

@@ -0,0 +1,22 @@
+import { lingui } from "@lingui/vite-plugin"
+import { defineConfig } from "@tanstack/react-start/config"
+import tsConfigPaths from "vite-tsconfig-paths"
+
+export default defineConfig({
+  tsr: {
+    appDirectory: "src",
+  },
+  react: {
+    babel: {
+      plugins: ["@lingui/babel-plugin-lingui-macro"],
+    },
+  },
+  vite: {
+    plugins: [
+      lingui(),
+      tsConfigPaths({
+        projects: ["./tsconfig.json"],
+      }),
+    ],
+  },
+})

examples/tanstack-start/lingui.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "@lingui/cli"
+
+export default defineConfig({
+  catalogs: [
+    {
+      include: ["src"],
+      path: "<rootDir>/src/locales/{locale}/messages",
+    },
+  ],
+  locales: ["fr", "en"],
+  sourceLocale: "en",
+})

examples/tanstack-start/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "tanstack-start",
+  "private": true,
+  "sideEffects": false,
+  "type": "module",
+  "scripts": {
+    "dev": "vinxi dev",
+    "build": "vinxi build",
+    "lingui:extract": "lingui extract --clean",
+    "start": "vinxi start"
+  },
+  "dependencies": {
+    "@lingui/core": "^5.3.0",
+    "@lingui/react": "^5.3.0",
+    "@tanstack/react-router": "^1.114.27",
+    "@tanstack/react-router-devtools": "^1.114.27",
+    "@tanstack/react-start": "^1.114.28",
+    "cookie-es": "^2.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "redaxios": "^0.5.1",
+    "tailwind-merge": "^2.6.0",
+    "vinxi": "0.5.3"
+  },
+  "devDependencies": {
+    "@lingui/babel-plugin-lingui-macro": "^5.3.0",
+    "@lingui/cli": "^5.3.0",
+    "@lingui/vite-plugin": "^5.3.0",
+    "@types/node": "^22.5.4",
+    "@types/react": "^19.0.8",
+    "@types/react-dom": "^19.0.3",
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.5.1",
+    "tailwindcss": "^3.4.17",
+    "typescript": "^5.7.2",
+    "vite-tsconfig-paths": "^5.1.4"
+  }
+}

examples/tanstack-start/postcss.config.mjs

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}