@linguanahq/cli 0.1.0 → 0.1.1

package/README.md

@@ -8,7 +8,7 @@ cd my-blog
 npm run dev
 ```
 
-Choose from `blog` (Elsewhere), `saas` (Relay), and `storefront` (Common Goods) on React, Vue, Svelte, SolidJS, or TanStack Start. All 15 apps are standalone and include local assets, English/French/Spanish/Arabic demo catalogs, deployment configuration, and an MIT license. Demo mode makes no Linguana API requests.
+Choose from `blank` (a minimal translated hello world with hot reload), `blog` (Elsewhere), `saas` (Relay), and `storefront` (Common Goods) on React, Vue, Svelte, SolidJS, or TanStack Start. All 20 apps are standalone and include local assets, English/French/Spanish/Arabic demo catalogs, deployment configuration, and an MIT license. Demo mode makes no Linguana API requests.
 
 **Initial release availability:** local demo scaffolding is available now. The hosted API and browser authorization deployment are pending, so `login`, `--connect`, `link`, and `env pull` require a compatible self-hosted server supplied with `--api-url` until that deployment is complete. Hosted template demo links are not included yet; run the generated apps locally using the commands above.
 
@@ -34,10 +34,10 @@ Owner/Admin access is required to create credentials. Provisioning reuses existi
 
 Options include `--package-manager npm|pnpm|yarn|bun`, `--skip-install`, `--organization`, `--project`, `--new-organization`, `--new-project`, `--locales`, `--environment`, `--api-url`, `--yes`, and `--json`. Run each command with `--help` for its supported options.
 
-The default API is `https://linguana-api.mohammedibrahim.dev`. Overrides require HTTPS, except HTTP loopback development. Authenticated requests do not follow redirects. `LINGUANA_CONFIG_DIR` overrides account-session storage; `LINGUANA_AUTH_TOKEN` can supply an account session for controlled automation. Never include either session credentials or build tokens in browser variables, committed files, or shared logs.
+The default API is `https://api.linguana.dev`. Overrides require HTTPS, except HTTP loopback development. Authenticated requests do not follow redirects. `LINGUANA_CONFIG_DIR` overrides account-session storage; `LINGUANA_AUTH_TOKEN` can supply an account session for controlled automation. Never include either session credentials or build tokens in browser variables, committed files, or shared logs.
 
 Exit codes: success `0`, operational failure `1`, invalid input `2`, cancellation `130`. If dependency installation fails, the generated app is retained. Interrupted connected setup can be resumed with `link`; its nonsecret recovery journal is `.linguana/setup.json`.
 
 Every generated app includes `DEPLOY.md` for Cloudflare and generic static hosting (or a Node server for TanStack Start). Hosting authentication and deployment are outside this CLI.
 
-[Full documentation](https://linguana-docs.mohammedibrahim.dev/docs/cli). New CLI and template code: MIT.
+[Full documentation](https://docs.linguana.dev/docs/cli). New CLI and template code: MIT.

package/dist/index.js

@@ -6,14 +6,17 @@ import { join as join5, resolve as resolve4 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { group } from "@clack/prompts";
 
+// package.json
+var version = "0.1.1";
+
 // ../templates/src/deployments.json
 var deployments_default = {};
 
 // ../templates/src/registry.ts
 var templateVersion = "0.1.0";
-var templateSourcePackageVersion = "0.1.0";
+var templateSourcePackageVersion = version;
 var sdkVersion = "0.1.1";
-var defaultApiUrl = "https://linguana-api.mohammedibrahim.dev";
+var defaultApiUrl = "https://api.linguana.dev";
 var frameworks = [
   "react",
   "vue",
@@ -28,7 +31,19 @@ var frameworkLabels = {
   solidjs: "SolidJS",
   "tanstack-start": "TanStack Start"
 };
-var templateIds = ["blog", "saas", "storefront"];
+var templateIds = ["blank", "blog", "saas", "storefront"];
+var blankTemplate = {
+  id: "blank",
+  name: "Blank",
+  category: "Hello world",
+  description: "A minimal starting point: the Linguana logo, a translated hello world, a language picker, and hot reload.",
+  color: "#2f5bea",
+  features: [
+    "Translated hello world",
+    "Language picker with RTL",
+    "Hot module reload"
+  ]
+};
 var templates = [
   {
     id: "blog",
@@ -67,8 +82,9 @@ var templates = [
     ]
   }
 ];
+var allTemplates = [blankTemplate, ...templates];
 var deployments = deployments_default;
-var variants = templates.flatMap(
+var variants = allTemplates.flatMap(
   (template) => frameworks.map((framework) => {
     const id = `${template.id}/${framework}`;
     return {
@@ -83,7 +99,7 @@ var variants = templates.flatMap(
       locales: ["en", "fr", "es", "ar"],
       sourceUrl: `https://unpkg.com/@linguanahq/cli@${templateSourcePackageVersion}/dist/templates/${id}/`,
       demoUrl: deployments[id]?.version === templateVersion ? deployments[id]?.url : void 0,
-      screenshot: `/templates/${template.id}-${framework}.png`,
+      screenshot: template.id === "blank" ? void 0 : `/templates/${template.id}-${framework}.png`,
       deploymentTargets: framework === "tanstack-start" ? ["cloudflare", "node"] : ["cloudflare", "static"]
     };
   })
@@ -186,6 +202,7 @@ function safeMessage(error) {
 }
 
 // src/api.ts
+var retiredOrigins = /* @__PURE__ */ new Set(["https://linguana-api.mohammedibrahim.dev"]);
 function apiOrigin(value = defaultApiUrl) {
   let url;
   try {
@@ -200,7 +217,7 @@ function apiOrigin(value = defaultApiUrl) {
       "INVALID_API_URL",
       2
     );
-  return url.origin;
+  return retiredOrigins.has(url.origin) ? new URL(defaultApiUrl).origin : url.origin;
 }
 var ApiError = class extends CliError {
   constructor(status, code, message, requestId) {
@@ -233,11 +250,18 @@ var Api = class {
       ]),
       headers: {
         "content-type": "application/json",
-        "user-agent": "linguana-cli/0.1.0",
+        "user-agent": `linguana-cli/${version}`,
         ...this.token ? { authorization: `Bearer ${this.token}` } : {},
         ...options.key ? { "idempotency-key": options.key } : {}
       },
       body: options.body === void 0 ? void 0 : JSON.stringify(options.body)
+    }).catch((error) => {
+      if (cancellation.signal.aborted || options.signal?.aborted) throw error;
+      const cause = error instanceof Error && error.cause instanceof Error ? error.cause.code ?? error.cause.message : error instanceof Error ? error.name === "TimeoutError" ? "timed out" : error.message : "network error";
+      throw new CliError(
+        `Could not reach Linguana at ${this.origin} (${cause}). Check your connection, or pass --api-url.`,
+        "NETWORK_ERROR"
+      );
     });
     const body = await response.json().catch(() => ({}));
     if (!response.ok)
@@ -1187,7 +1211,7 @@ process.once("SIGINT", () => {
   cancellation.abort();
   process.exitCode = 130;
 });
-var program = new Command().name("linguana").description("Create and connect multilingual apps with Linguana.").version("0.1.0").option("--json", "Print structured results without secrets").option("--yes", "Use defaults without prompting").option("--api-url <origin>", "Linguana API origin").showHelpAfterError().exitOverride();
+var program = new Command().name("linguana").description("Create and connect multilingual apps with Linguana.").version(version).option("--json", "Print structured results without secrets").option("--yes", "Use defaults without prompting").option("--api-url <origin>", "Linguana API origin").showHelpAfterError().exitOverride();
 var opts = (command) => command.optsWithGlobals();
 function projectOptions(command) {
   return command.option("--organization <id>", "Existing organization ID").option("--project <id>", "Existing project ID").option("--new-organization <name>", "Create an organization").option("--new-project <name>", "Create a project").option(
@@ -1275,7 +1299,7 @@ async function originFor(options) {
   );
 }
 projectOptions(
-  program.command("create").description("Create a new app").command("app [directory]").option("--template <template>", "blog, saas, or storefront").option("--demo", "Use bundled translations without an account").option("--connect", "Connect a Linguana project").option("--package-manager <manager>", "npm, pnpm, yarn, or bun").option("--skip-install", "Write files without installing dependencies")
+  program.command("create").description("Create a new app").command("app [directory]").option("--template <template>", "blank, blog, saas, or storefront").option("--demo", "Use bundled translations without an account").option("--connect", "Connect a Linguana project").option("--package-manager <manager>", "npm, pnpm, yarn, or bun").option("--skip-install", "Write files without installing dependencies")
 ).action(
   async (directory, _local, command) => {
     const options = opts(command);
@@ -1284,7 +1308,7 @@ projectOptions(
     const choices = {
       template: async () => options.template ?? await ui.choose(
         "Choose a template",
-        templates.map((item) => ({
+        allTemplates.map((item) => ({
           value: item.id,
           label: `${item.name} \u2014 ${item.category}`
         }))
@@ -1301,7 +1325,7 @@ projectOptions(
     const template = selectedChoices.template;
     if (!templateIds.includes(template))
       throw new CliError(
-        "Template must be blog, saas, or storefront.",
+        "Template must be blank, blog, saas, or storefront.",
         "INVALID_TEMPLATE",
         2
       );
@@ -1309,7 +1333,10 @@ projectOptions(
     const framework = normalizeFramework(selected);
     if (!framework)
       throw new CliError("Unsupported framework.", "INVALID_FRAMEWORK", 2);
-    const target = directory ?? await ui.input("Where should we create your app?", `my-${template}`);
+    const target = directory ?? await ui.input(
+      "Where should we create your app?",
+      template === "blank" ? "my-app" : `my-${template}`
+    );
     try {
       await validateDestination(target);
     } catch (error) {
@@ -1399,8 +1426,8 @@ Builds upload manifests. Paid translation and production publishing remain expli
 program.command("templates").command("list").action((_local, command) => {
   const ui = new Ui(opts(command));
   ui.result(
-    { templates, variants },
-    templates.map(
+    { templates: allTemplates, variants },
+    allTemplates.map(
       (item) => `${item.id.padEnd(12)} ${item.name} \u2014 ${item.description}
   ${frameworks.join(", ")}${variants.filter(
         (variant) => variant.template === item.id && variant.demoUrl
@@ -1485,7 +1512,7 @@ projectOptions(
     result,
     `Connected ${result.projectId}. Wrote ${result.envFile}.
 Project: ${result.projectUrl}
-${frameworkLabels[result.config.framework]} integration: https://linguana-docs.mohammedibrahim.dev/docs/${integration}
+${frameworkLabels[result.config.framework]} integration: https://docs.linguana.dev/docs/${integration}
 Add the Linguana Vite adapter before your framework plugin and load the environment with loadEnv. ${provider} See the integration guide for exact imports.`
   );
 });

package/dist/templates/blank/react/.env.example

@@ -0,0 +1,15 @@
+# Demo mode works without credentials. Connect with npx @linguanahq/cli link.
+# Copying this file alone does not enable connected mode; use linguana.json.
+# Build/server only. NEVER prefix the project token with VITE_.
+LINGUANA_PROJECT_ID=
+LINGUANA_ENVIRONMENT=development
+LINGUANA_API_URL=https://api.linguana.dev
+LINGUANA_PROJECT_TOKEN=
+LINGUANA_UPLOAD=false
+# Paid translation is disabled; this template does not enable it automatically.
+LINGUANA_TRANSLATE=false
+# Browser-safe values. A publishable key reads published catalogs only.
+VITE_LINGUANA_PROJECT_ID=
+VITE_LINGUANA_ENVIRONMENT=development
+VITE_LINGUANA_API_URL=https://api.linguana.dev
+VITE_LINGUANA_PUBLISHABLE_KEY=

package/dist/templates/blank/react/ASSETS.md

@@ -0,0 +1 @@
+The Linguana logo and favicon in public/ are Linguana brand assets, included so the starter renders out of the box. Replace them with your own. Sample translations are MIT. No remote images, tracking pixels, or font services are used.

package/dist/templates/blank/react/DEPLOY.md

@@ -0,0 +1,23 @@
+# Deploy Blank
+
+Demo mode needs no Linguana account. Hosting authentication is separate from the Linguana CLI.
+
+## Cloudflare Workers
+
+Install dependencies, choose a unique Worker name in wrangler.jsonc, then:
+
+```sh
+npx wrangler login
+npm run build
+npx wrangler deploy
+```
+
+Wrangler serves dist as static assets with single-page navigation fallback. Unknown paths fall back to index.html.
+
+## Any static host
+
+Run `npm run build` and publish dist/. Configure unknown paths to serve /index.html with status 200 (SPA fallback). A static preview can be started with `npm run preview`. Do not publish the project root.
+
+## Connected deployments
+
+Pull the intended environment with `linguana env pull --environment production`. Configure the variables from .env.example in the build host, including the matching public project/environment values. Build tokens are secrets used by the compiler only. Never upload .env files or the CLI account session. LINGUANA_TRANSLATE remains false. Catalog publication is an explicit dashboard action.

package/dist/templates/blank/react/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Linguana contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/templates/blank/react/README.md

@@ -0,0 +1,34 @@
+# Blank
+
+A minimal starting point: the Linguana logo, a translated hello world, a language picker, and hot reload.
+
+A standalone react app, generated from Linguana templates v0.1.0. Requires Node 22.12+ (or Bun).
+
+## Run
+
+```sh
+npm install
+npm run dev
+```
+
+You can also use pnpm, Yarn, or Bun. English, French, Spanish, and Arabic catalogs are bundled in demo mode. No Linguana API requests are made. The language cookie persists between visits. Arabic switches the document to RTL.
+
+## Connect your own project
+
+```sh
+npx @linguanahq/cli login
+npx @linguanahq/cli link
+npx @linguanahq/cli doctor
+```
+
+Linking writes nonsecret `linguana.json` and ignored `.env.local`. The account session stays outside this project. Only the public project ID, environment, API URL, and publishable key reach the browser. Build tokens never belong in `VITE_*` variables.
+
+Connected mode uses your published project catalogs and English source fallback. It does not load demo translations. Builds can upload the source manifest but do not start paid translations or publish catalogs. Review and publish translations in your dashboard. Existing project languages remain unchanged unless you pass `--locales`.
+
+To target another environment, use `linguana env pull --environment staging`, then `npm run build -- --mode staging`. Production uses `.env.production.local` and Vite's default production build mode. Configure matching private and public values on your build host; see .env.example.
+
+## Customize
+
+Start in src/App.tsx. Vite hot reload applies your edits as you save, without losing the selected language. Add a message by giving it a stable ID in src/Copy.tsx with its English text, a source fallback in src/messages.ts, and demo translations in src/demo-messages.ts.
+
+Run `npm run check-types` and `npm run build` before deploying. Deployment instructions are in DEPLOY.md. See LICENSE and ASSETS.md.

package/dist/templates/blank/react/_gitignore

@@ -0,0 +1,11 @@
+node_modules/
+dist/
+.output/
+.nitro/
+.tanstack/
+.wrangler/
+.env
+.env.local
+.env.*.local
+.linguana/
+*.log

package/dist/templates/blank/react/index.html

@@ -0,0 +1,2 @@
+<!doctype html>
+<html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="description" content="A minimal starting point: the Linguana logo, a translated hello world, a language picker, and hot reload."><meta name="theme-color" content="#2f5bea"><link rel="icon" href="/favicon.ico" sizes="any"><title>Blank</title></head><body><div id="app"></div><script type="module" src="/src/main.tsx"></script></body></html>

package/dist/templates/blank/react/linguana.json

@@ -0,0 +1,10 @@
+{
+	"schemaVersion": 1,
+	"framework": "react",
+	"template": "blank",
+	"templateVersion": "0.1.0",
+	"mode": "demo",
+	"apiUrl": "https://api.linguana.dev",
+	"sourceLocale": "en",
+	"defaultEnvironment": "development"
+}

package/dist/templates/blank/react/package.json

@@ -0,0 +1,34 @@
+{
+	"name": "blank-react",
+	"version": "0.1.0",
+	"private": true,
+	"type": "module",
+	"license": "MIT",
+	"engines": {
+		"node": ">=22.12.0"
+	},
+	"scripts": {
+		"dev": "vite --host 127.0.0.1",
+		"build": "vite build",
+		"preview": "vite preview",
+		"check-types": "tsc --noEmit",
+		"deploy": "npm run build && wrangler deploy"
+	},
+	"dependencies": {
+		"@linguanahq/catalog": "0.1.1",
+		"@linguanahq/core": "0.1.1",
+		"@linguanahq/react": "0.1.1",
+		"react": "^19.2.7",
+		"react-dom": "^19.2.7"
+	},
+	"devDependencies": {
+		"@linguanahq/vite": "0.1.1",
+		"typescript": "^6.0.0",
+		"vite": "^8.1.3",
+		"@types/node": "^24.0.0",
+		"wrangler": "^4.127.0",
+		"@types/react": "^19.2.17",
+		"@types/react-dom": "^19.2.3",
+		"@vitejs/plugin-react": "^6.0.3"
+	}
+}

package/dist/templates/blank/react/src/App.tsx

@@ -0,0 +1,72 @@
+import { useTranslation } from "@linguanahq/react";
+import { Fragment, useEffect } from "react";
+import Copy from "./Copy.tsx";
+import { demoLocales } from "./i18n";
+import { messages } from "./messages";
+
+export default function App() {
+	const runtime = useTranslation();
+	const locale = () => runtime.locale;
+	const locales = () =>
+		runtime.availableLocales.length
+			? runtime.availableLocales
+			: demoLocales.filter((item) => item.code === runtime.sourceLocale);
+	const translate = runtime.translate;
+	const changeLocale = (value: string) => void runtime.setLocale(value);
+	useEffect(() => {
+		document.documentElement.lang = runtime.locale;
+		document.documentElement.dir = runtime.locale.startsWith("ar")
+			? "rtl"
+			: "ltr";
+	}, [runtime.locale]);
+	const msg = (id: string, values?: Record<string, string | number>) =>
+		String(translate(id, messages[id] ?? id, values));
+	const value = (event: Event | { currentTarget: EventTarget | null }) =>
+		(event.currentTarget as HTMLSelectElement).value;
+
+	return (
+		<main className="hello">
+			<img
+				src="/logo.png"
+				alt={msg("logoAlt")}
+				className="hello-logo"
+				width={96}
+				height={96}
+			/>
+			<h1>
+				<Copy name="hello" />
+			</h1>
+			<p className="hello-intro">
+				<Copy name="intro" />
+			</p>
+			<label className="locale-picker">
+				<span className="sr-only">
+					<Copy name="language" />
+				</span>
+				<select
+					value={locale()}
+					aria-label={msg("language")}
+					onChange={(event) => {
+						changeLocale(value(event));
+					}}
+				>
+					{locales().map((language) => (
+						<Fragment key={language.code}>
+							<option value={language.code}>{language.nativeName}</option>
+						</Fragment>
+					))}
+				</select>
+			</label>
+			<p className="hello-hint">
+				<Copy name="hotReload" values={{ file: "src/App.tsx" }} />
+			</p>
+			<a
+				href="https://docs.linguana.dev"
+				className="hello-link"
+				rel="noreferrer"
+			>
+				<Copy name="docs" />
+			</a>
+		</main>
+	);
+}

package/dist/templates/blank/react/src/Copy.tsx

@@ -0,0 +1,36 @@
+import { T } from "@linguanahq/react";
+export default function Copy(props: {
+	name: string;
+	values?: Record<string, string | number>;
+}) {
+	return (
+		<>
+			{props.name === "language" && (
+				<T id="language" defaultMessage="Language" values={props.values} />
+			)}
+			{props.name === "hello" && (
+				<T id="hello" defaultMessage="Hello, world!" values={props.values} />
+			)}
+			{props.name === "intro" && (
+				<T
+					id="intro"
+					defaultMessage="Your multilingual app is ready. Pick a language to see it translated."
+					values={props.values}
+				/>
+			)}
+			{props.name === "hotReload" && (
+				<T
+					id="hotReload"
+					defaultMessage="Edit {file} and save. The page updates instantly."
+					values={props.values}
+				/>
+			)}
+			{props.name === "docs" && (
+				<T id="docs" defaultMessage="Read the docs" values={props.values} />
+			)}
+			{props.name === "logoAlt" && (
+				<T id="logoAlt" defaultMessage="Linguana logo" values={props.values} />
+			)}
+		</>
+	);
+}

package/dist/templates/blank/react/src/demo-messages.ts

@@ -0,0 +1,30 @@
+// These catalogs are only used when linguana.json selects demo mode.
+export const demoMessages = {
+	fr: {
+		language: "Langue",
+		hello: "Bonjour, le monde !",
+		intro:
+			"Votre application multilingue est prête. Choisissez une langue pour la voir traduite.",
+		hotReload:
+			"Modifiez {file} et enregistrez. La page se met à jour instantanément.",
+		docs: "Lire la documentation",
+		logoAlt: "Logo Linguana",
+	},
+	es: {
+		language: "Idioma",
+		hello: "¡Hola, mundo!",
+		intro:
+			"Tu aplicación multilingüe está lista. Elige un idioma para verla traducida.",
+		hotReload: "Edita {file} y guarda. La página se actualiza al instante.",
+		docs: "Leer la documentación",
+		logoAlt: "Logotipo de Linguana",
+	},
+	ar: {
+		language: "اللغة",
+		hello: "مرحبًا بالعالم!",
+		intro: "تطبيقك متعدد اللغات جاهز. اختر لغة لتراه مترجمًا.",
+		hotReload: "عدّل {file} واحفظه. تتحدّث الصفحة فورًا.",
+		docs: "اقرأ التوثيق",
+		logoAlt: "شعار Linguana",
+	},
+};

package/dist/templates/blank/react/src/i18n.ts

@@ -0,0 +1,62 @@
+import { createCatalog } from "@linguanahq/catalog";
+import config from "../linguana.json";
+import { demoMessages } from "./demo-messages";
+export const demoLocales = [
+	{ code: "en", displayName: "English", nativeName: "English" },
+	{ code: "fr", displayName: "French", nativeName: "Français" },
+	{ code: "es", displayName: "Spanish", nativeName: "Español" },
+	{ code: "ar", displayName: "Arabic", nativeName: "العربية" },
+];
+export const demo = config.mode === "demo";
+export function cookieLocale(
+	cookie = typeof document === "undefined" ? "" : document.cookie,
+) {
+	try {
+		const value = decodeURIComponent(
+			cookie
+				.split(";")
+				.find((item) => item.trim().startsWith("linguana_locale="))
+				?.split("=")[1] ?? "en",
+		);
+		return /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(value) &&
+			(!demo || demoLocales.some((item) => item.code === value))
+			? value
+			: "en";
+	} catch {
+		return "en";
+	}
+}
+export const demoCatalogs = demo
+	? Object.entries(demoMessages).map(([locale, messages]) =>
+			createCatalog({
+				schemaVersion: "1.0",
+				projectId: "demo-blank",
+				environment: "development",
+				sourceLocale: "en",
+				locale,
+				manifestHash: "0".repeat(64),
+				version: 1,
+				messages,
+			}),
+		)
+	: [];
+export function optionsFor(
+	locale = cookieLocale(),
+): import("@linguanahq/core").LinguanaClientOptions {
+	return {
+		projectId: demo ? "demo-blank" : import.meta.env.VITE_LINGUANA_PROJECT_ID,
+		environment: demo
+			? "development"
+			: import.meta.env.VITE_LINGUANA_ENVIRONMENT,
+		initialLocale: locale,
+		fallbackLocale: config.sourceLocale,
+		catalogs: demoCatalogs,
+		...(demo
+			? { availableLocales: demoLocales }
+			: {
+					publishableKey: import.meta.env.VITE_LINGUANA_PUBLISHABLE_KEY,
+					catalogEndpoint: import.meta.env.VITE_LINGUANA_API_URL,
+					configEndpoint: import.meta.env.VITE_LINGUANA_API_URL,
+				}),
+	};
+}

package/dist/templates/blank/react/src/main.tsx

@@ -0,0 +1,11 @@
+import { LocaleProvider } from "@linguanahq/react";
+import { createRoot } from "react-dom/client";
+import App from "./App";
+import { optionsFor } from "./i18n";
+import "./styles.css";
+
+createRoot(document.getElementById("app")!).render(
+	<LocaleProvider {...optionsFor()}>
+		<App />
+	</LocaleProvider>,
+);

package/dist/templates/blank/react/src/messages.ts

@@ -0,0 +1,10 @@
+// Source fallbacks; matching extractable literals live in Copy.tsx.
+export const messages: Record<string, string> = {
+	language: "Language",
+	hello: "Hello, world!",
+	intro:
+		"Your multilingual app is ready. Pick a language to see it translated.",
+	hotReload: "Edit {file} and save. The page updates instantly.",
+	docs: "Read the docs",
+	logoAlt: "Linguana logo",
+};