@linguanahq/cli 0.1.0 → 0.1.1

package/dist/templates/blank/react/src/styles.css

@@ -0,0 +1,93 @@
+* {
+	box-sizing: border-box;
+}
+body {
+	margin: 0;
+	min-height: 100vh;
+	display: grid;
+	place-items: center;
+	background: #f7f8fb;
+	color: #14213d;
+	font-family: system-ui, -apple-system, "Segoe UI", Roboto, Arial, sans-serif;
+	line-height: 1.6;
+}
+button,
+select {
+	font: inherit;
+}
+.hello {
+	display: flex;
+	flex-direction: column;
+	align-items: center;
+	gap: 1rem;
+	max-width: 36rem;
+	padding: 3rem 1.5rem;
+	text-align: center;
+}
+.hello-logo {
+	width: 6rem;
+	height: 6rem;
+}
+.hello h1 {
+	margin: 0;
+	font-size: clamp(2.5rem, 8vw, 4rem);
+	line-height: 1.1;
+	letter-spacing: -0.02em;
+}
+.hello-intro {
+	margin: 0;
+	color: #46536b;
+	font-size: 1.125rem;
+}
+.locale-picker select {
+	min-height: 2.75rem;
+	padding: 0.5rem 2.5rem 0.5rem 1rem;
+	border: 1px solid #c9d1e0;
+	border-radius: 0.5rem;
+	background: #fff;
+	color: inherit;
+	cursor: pointer;
+}
+.locale-picker select:focus-visible,
+.hello-link:focus-visible {
+	outline: 3px solid #2f5bea;
+	outline-offset: 2px;
+}
+.hello-hint {
+	margin: 0.5rem 0 0;
+	color: #46536b;
+	font-size: 0.9375rem;
+}
+.hello-link {
+	color: #2f5bea;
+	font-weight: 600;
+	text-underline-offset: 0.2em;
+}
+.sr-only {
+	position: absolute;
+	width: 1px;
+	height: 1px;
+	padding: 0;
+	margin: -1px;
+	overflow: hidden;
+	clip: rect(0, 0, 0, 0);
+	white-space: nowrap;
+	border: 0;
+}
+@media (prefers-color-scheme: dark) {
+	body {
+		background: #0f1420;
+		color: #eef1f7;
+	}
+	.hello-intro,
+	.hello-hint {
+		color: #aab4c8;
+	}
+	.locale-picker select {
+		background: #182033;
+		border-color: #33405c;
+	}
+	.hello-link {
+		color: #8ea8ff;
+	}
+}

package/dist/templates/blank/react/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

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

@@ -0,0 +1,23 @@
+{
+	"compilerOptions": {
+		"target": "ES2022",
+		"module": "ESNext",
+		"lib": ["ES2022", "DOM", "DOM.Iterable"],
+		"moduleResolution": "Bundler",
+		"strict": true,
+		"skipLibCheck": true,
+		"esModuleInterop": true,
+		"allowImportingTsExtensions": true,
+		"resolveJsonModule": true,
+		"noEmit": true,
+		"types": ["vite/client", "node"],
+		"jsx": "react-jsx"
+	},
+	"include": [
+		"src/**/*.ts",
+		"src/**/*.tsx",
+		"src/**/*.vue",
+		"src/**/*.svelte",
+		"vite.config.ts"
+	]
+}

package/dist/templates/blank/react/vite.config.ts

@@ -0,0 +1,36 @@
+import { linguana } from "@linguanahq/vite";
+import { react } from "@linguanahq/vite/react";
+import native from "@vitejs/plugin-react";
+import { defineConfig, loadEnv } from "vite";
+import config from "./linguana.json" with { type: "json" };
+
+export default defineConfig(({ mode }) => {
+	const env = { ...loadEnv(mode, process.cwd(), ""), ...process.env };
+	const connected = config.mode === "connected";
+	if (
+		connected &&
+		(!env.LINGUANA_PROJECT_ID ||
+			!env.VITE_LINGUANA_PUBLISHABLE_KEY ||
+			env.LINGUANA_PROJECT_ID !== env.VITE_LINGUANA_PROJECT_ID ||
+			env.LINGUANA_ENVIRONMENT !== env.VITE_LINGUANA_ENVIRONMENT ||
+			env.LINGUANA_API_URL !== env.VITE_LINGUANA_API_URL)
+	)
+		throw new Error(
+			"Linguana environment is incomplete or inconsistent. Run linguana env pull for this build mode.",
+		);
+	return {
+		plugins: [
+			linguana({
+				adapter: react(),
+				projectId: connected ? env.LINGUANA_PROJECT_ID! : "demo-blank",
+				environment: connected ? env.LINGUANA_ENVIRONMENT : "development",
+				sourceLocale: config.sourceLocale,
+				apiUrl: connected ? env.LINGUANA_API_URL : undefined,
+				token: connected ? env.LINGUANA_PROJECT_TOKEN : undefined,
+				upload: connected && env.LINGUANA_UPLOAD === "true",
+				translation: false,
+			}),
+			native(),
+		],
+	};
+});

package/dist/templates/blank/react/wrangler.jsonc

@@ -0,0 +1,8 @@
+{
+  "name": "linguana-demo-blank-react",
+  "compatibility_date": "2026-10-01",
+  "assets": {
+    "directory": "./dist",
+    "not_found_handling": "single-page-application"
+  }
+}

package/dist/templates/blank/solidjs/.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/solidjs/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/solidjs/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/solidjs/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/solidjs/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 solidjs 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/solidjs/_gitignore

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

package/dist/templates/blank/solidjs/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/solidjs/linguana.json

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

package/dist/templates/blank/solidjs/package.json

@@ -0,0 +1,31 @@
+{
+	"name": "blank-solidjs",
+	"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/solid": "0.1.1",
+		"solid-js": "^1.9.10"
+	},
+	"devDependencies": {
+		"@linguanahq/vite": "0.1.1",
+		"typescript": "^6.0.0",
+		"vite": "^8.1.3",
+		"@types/node": "^24.0.0",
+		"wrangler": "^4.127.0",
+		"vite-plugin-solid": "^2.11.10"
+	}
+}

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

@@ -0,0 +1,68 @@
+import { useTranslation } from "@linguanahq/solid";
+import { createEffect, For } from "solid-js";
+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 translate = runtime.translate;
+	const locales = () =>
+		runtime.availableLocales().length
+			? runtime.availableLocales()
+			: demoLocales.filter((item) => item.code === "en");
+	const changeLocale = (value: string) => void runtime.setLocale(value);
+	createEffect(() => {
+		document.documentElement.lang = locale();
+		document.documentElement.dir = locale().startsWith("ar") ? "rtl" : "ltr";
+	});
+	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 class="hello">
+			<img
+				src="/logo.png"
+				alt={msg("logoAlt")}
+				class="hello-logo"
+				width={96}
+				height={96}
+			/>
+			<h1>
+				<Copy name="hello" />
+			</h1>
+			<p class="hello-intro">
+				<Copy name="intro" />
+			</p>
+			<label class="locale-picker">
+				<span class="sr-only">
+					<Copy name="language" />
+				</span>
+				<select
+					value={locale()}
+					aria-label={msg("language")}
+					onChange={(event) => {
+						changeLocale(value(event));
+					}}
+				>
+					<For each={locales()}>
+						{(language) => (
+							<>
+								<option value={language.code}>{language.nativeName}</option>
+							</>
+						)}
+					</For>
+				</select>
+			</label>
+			<p class="hello-hint">
+				<Copy name="hotReload" values={{ file: "src/App.tsx" }} />
+			</p>
+			<a href="https://docs.linguana.dev" class="hello-link" rel="noreferrer">
+				<Copy name="docs" />
+			</a>
+		</main>
+	);
+}

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

@@ -0,0 +1,36 @@
+import { T } from "@linguanahq/solid";
+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/solidjs/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/solidjs/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/solidjs/src/main.tsx

@@ -0,0 +1,14 @@
+import { LinguanaProvider } from "@linguanahq/solid";
+import { render } from "solid-js/web";
+import App from "./App";
+import { optionsFor } from "./i18n";
+import "./styles.css";
+
+render(
+	() => (
+		<LinguanaProvider {...optionsFor()}>
+			<App />
+		</LinguanaProvider>
+	),
+	document.getElementById("app")!,
+);

package/dist/templates/blank/solidjs/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",
+};

package/dist/templates/blank/solidjs/src/styles.css

@@ -0,0 +1,93 @@
+* {
+	box-sizing: border-box;
+}
+body {
+	margin: 0;
+	min-height: 100vh;
+	display: grid;
+	place-items: center;
+	background: #f7f8fb;
+	color: #14213d;
+	font-family: system-ui, -apple-system, "Segoe UI", Roboto, Arial, sans-serif;
+	line-height: 1.6;
+}
+button,
+select {
+	font: inherit;
+}
+.hello {
+	display: flex;
+	flex-direction: column;
+	align-items: center;
+	gap: 1rem;
+	max-width: 36rem;
+	padding: 3rem 1.5rem;
+	text-align: center;
+}
+.hello-logo {
+	width: 6rem;
+	height: 6rem;
+}
+.hello h1 {
+	margin: 0;
+	font-size: clamp(2.5rem, 8vw, 4rem);
+	line-height: 1.1;
+	letter-spacing: -0.02em;
+}
+.hello-intro {
+	margin: 0;
+	color: #46536b;
+	font-size: 1.125rem;
+}
+.locale-picker select {
+	min-height: 2.75rem;
+	padding: 0.5rem 2.5rem 0.5rem 1rem;
+	border: 1px solid #c9d1e0;
+	border-radius: 0.5rem;
+	background: #fff;
+	color: inherit;
+	cursor: pointer;
+}
+.locale-picker select:focus-visible,
+.hello-link:focus-visible {
+	outline: 3px solid #2f5bea;
+	outline-offset: 2px;
+}
+.hello-hint {
+	margin: 0.5rem 0 0;
+	color: #46536b;
+	font-size: 0.9375rem;
+}
+.hello-link {
+	color: #2f5bea;
+	font-weight: 600;
+	text-underline-offset: 0.2em;
+}
+.sr-only {
+	position: absolute;
+	width: 1px;
+	height: 1px;
+	padding: 0;
+	margin: -1px;
+	overflow: hidden;
+	clip: rect(0, 0, 0, 0);
+	white-space: nowrap;
+	border: 0;
+}
+@media (prefers-color-scheme: dark) {
+	body {
+		background: #0f1420;
+		color: #eef1f7;
+	}
+	.hello-intro,
+	.hello-hint {
+		color: #aab4c8;
+	}
+	.locale-picker select {
+		background: #182033;
+		border-color: #33405c;
+	}
+	.hello-link {
+		color: #8ea8ff;
+	}
+}

package/dist/templates/blank/solidjs/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />