@h-ai/cli 0.1.0-alpha.16 → 0.1.0-alpha.19

package/templates/apps/fullstack/apps/{{projectName}}-desktop/eslint.config.js.hbs

@@ -0,0 +1,23 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+import antfu from '@antfu/eslint-config'
+
+export default antfu({
+  formatters: true,
+  ignores: ['**/.svelte-kit/**', '**/build/**', '**/dist/**', '**/*.d.ts', '**/project.inlang/**', '**/src/lib/paraglide/**'],
+  svelte: true,
+}, {
+  files: ['**/*.ts', '**/*.svelte'],
+  rules: {
+    'no-console': 'error',
+    'ts/no-explicit-any': 'error',
+  },
+}, {
+  files: ['**/*.svelte'],
+  rules: {
+    'svelte/html-quotes': 'off',
+    'svelte/indent': 'off',
+    'perfectionist/sort-imports': 'off',
+  },
+})
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/messages/en-US.json.hbs

@@ -0,0 +1,34 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "page_title": "{name} · Desktop",
+  "platform_name": "Desktop",
+  "hero_badge": "Desktop workspace",
+  "hero_title": "{name} Desktop Command Center",
+  "hero_subtitle": "A wide-screen desktop starter that can later integrate Tauri while reusing shared shell, theme, locale and API client capabilities.",
+  "hero_primary_action": "View service status",
+  "hero_secondary_action": "Customize the starter",
+  "preview_title": "Desktop productivity UI",
+  "preview_body": "Ready for command centers, tool workspaces and native-enhanced apps",
+  "preview_metric_shared": "Shared UI/API capabilities",
+  "preview_metric_local": "Desktop-owned messages",
+  "preview_metric_theme": "Configurable themes",
+  "status_title": "Service connectivity",
+  "status_description": "The desktop page calls the backend service to verify API contract, service and shared client wiring.",
+  "status_online": "{name} is connected",
+  "status_version": "Service version",
+  "status_started": "Started at: {time}",
+  "status_frontends": "Service frontends: {list}",
+  "status_frontends_count": "{count} frontend targets",
+  "custom_shared_title": "Shared owns common capabilities",
+  "custom_shared_body": "Common shell, theme, locale switching and API client live in packages/{{projectName}}-shared and are reused by Desktop.",
+  "custom_local_title": "Desktop owns desktop copy",
+  "custom_local_body": "Desktop-specific menus, states and feature descriptions live in apps/{{projectName}}-desktop/messages.",
+  "flow_title": "Collaboration boundary",
+  "flow_contract": "Contract locks API contracts",
+  "flow_service": "Service provides runtime capabilities",
+  "flow_shared": "Shared reuses cross-platform UI/API",
+  "flow_frontend": "Desktop composes the product experience"
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/messages/zh-CN.json.hbs

@@ -0,0 +1,34 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "page_title": "{name} · Desktop",
+  "platform_name": "Desktop",
+  "hero_badge": "桌面端工作台",
+  "hero_title": "{name} Desktop 控制中心",
+  "hero_subtitle": "面向桌面端的大屏工作台样板，可后续接入 Tauri，同时复用 shared 的 Shell、主题、语言与 API 客户端。",
+  "hero_primary_action": "查看服务状态",
+  "hero_secondary_action": "了解如何自定义",
+  "preview_title": "桌面端生产力界面",
+  "preview_body": "适合控制中心、工具台与本地增强应用",
+  "preview_metric_shared": "共享 UI/API 能力",
+  "preview_metric_local": "Desktop 自有 messages",
+  "preview_metric_theme": "主题可配置",
+  "status_title": "服务联通状态",
+  "status_description": "桌面端页面会调用后端服务，确认 API contract、service 与 shared client 链路正常。",
+  "status_online": "{name} 已连接",
+  "status_version": "服务版本",
+  "status_started": "启动时间：{time}",
+  "status_frontends": "服务声明的前端：{list}",
+  "status_frontends_count": "{count} 个前端目标",
+  "custom_shared_title": "共享层放通用能力",
+  "custom_shared_body": "通用 Shell、主题、语言切换和 API client 放在 packages/{{projectName}}-shared，桌面端直接复用。",
+  "custom_local_title": "Desktop 层放桌面文案",
+  "custom_local_body": "桌面端特有菜单、状态与功能说明写在 apps/{{projectName}}-desktop/messages。",
+  "flow_title": "协同边界",
+  "flow_contract": "Contract 固化接口契约",
+  "flow_service": "Service 提供运行时能力",
+  "flow_shared": "Shared 复用跨端基础 UI/API",
+  "flow_frontend": "Desktop 组合桌面产品体验"
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/package.json.hbs

@@ -0,0 +1,50 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "name": "{{projectName}}-desktop",
+  "type": "module",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "paraglide:compile": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide",
+    "paraglide:watch": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide --watch",
+    "dev": "vite dev --host 127.0.0.1 --port {{fullstack.ports.desktop}}",
+    "build": "vite build",
+    "preview": "vite preview --host 127.0.0.1 --port {{fullstack.ports.desktop}} --strictPort",
+    "typecheck": "pnpm paraglide:compile && svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rimraf .svelte-kit build .turbo src/lib/paraglide"
+  },
+  "dependencies": {
+    "@h-ai/api-client": "{{fullstack.versions.apiClient}}",
+    "@h-ai/ui": "{{fullstack.versions.ui}}",
+    "{{fullstack.contractPackageName}}": "workspace:*",
+    "{{fullstack.sharedPackageName}}": "workspace:*"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "{{fullstack.versions.antfuEslintConfig}}",
+    "@iconify-json/tabler": "{{fullstack.versions.iconifyJsonTabler}}",
+    "@iconify/tailwind4": "{{fullstack.versions.iconifyTailwind}}",
+    "@inlang/paraglide-js": "{{fullstack.versions.inlangParaglide}}",
+    "@inlang/plugin-message-format": "{{fullstack.versions.inlangMessageFormat}}",
+    "@sveltejs/adapter-auto": "{{fullstack.versions.adapterAuto}}",
+    "@sveltejs/kit": "{{fullstack.versions.svelteKit}}",
+    "@sveltejs/vite-plugin-svelte": "{{fullstack.versions.sveltePlugin}}",
+    "@tailwindcss/vite": "{{fullstack.versions.tailwindcssVite}}",
+    "bits-ui": "{{fullstack.versions.bitsUi}}",
+    "daisyui": "{{fullstack.versions.daisyui}}",
+    "eslint": "{{fullstack.versions.eslint}}",
+    "eslint-plugin-format": "{{fullstack.versions.eslintPluginFormat}}",
+    "eslint-plugin-svelte": "{{fullstack.versions.eslintPluginSvelte}}",
+    "svelte": "{{fullstack.versions.svelte}}",
+    "svelte-check": "{{fullstack.versions.svelteCheck}}",
+    "svelte-eslint-parser": "{{fullstack.versions.svelteEslintParser}}",
+    "tailwindcss": "{{fullstack.versions.tailwindcss}}",
+    "typescript": "{{fullstack.versions.typescript}}",
+    "vite": "{{fullstack.versions.vite}}",
+    "vitest": "{{fullstack.versions.vitest}}"
+  }
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/project.inlang/settings.json.hbs

@@ -0,0 +1,17 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "$schema": "https://inlang.com/schema/project-settings",
+  "baseLocale": "{{fullstack.i18n.baseLocale}}",
+  "locales": [
+    {{#each fullstack.i18n.locales}}"{{this}}"{{#unless @last}},{{/unless}}
+    {{/each}}
+  ],
+  "modules": [
+    "https://cdn.jsdelivr.net/npm/@inlang/plugin-message-format@latest/dist/index.js"
+  ],
+  "plugin.inlang.messageFormat": {
+    "pathPattern": "./messages/{locale}.json"
+  }
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src/app.css.hbs

@@ -0,0 +1,18 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+@import 'tailwindcss';
+@import '@h-ai/ui/styles/global.css';
+@import '@h-ai/ui/styles/theme.css';
+@source "../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+@source "../../../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+@source "../../../packages/{{fullstack.sharedPackageName}}/src/**/*.{svelte,js,ts}";
+
+@plugin "daisyui" {
+  themes:
+    {{#each fullstack.theme.themes}}{{this}}{{#if_eq this ../fullstack.theme.defaultTheme}} --default{{/if_eq}}{{#unless @last}},
+    {{/unless}}{{/each}};
+}
+@plugin "@iconify/tailwind4" {
+  prefixes: tabler;
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src/app.d.ts.hbs

@@ -0,0 +1,9 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+/// <reference types="@sveltejs/kit" />
+/// <reference types="vite/client" />
+
+import '@h-ai/ui/auto-import'
+
+declare module '*.css'
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src/app.html.hbs

@@ -0,0 +1,14 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+<!doctype html>
+<html lang="%paraglide.lang%">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    %sveltekit.head%
+  </head>
+  <body data-sveltekit-preload-data="hover">
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
+</html>
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src/routes/+layout.svelte.hbs

@@ -0,0 +1,18 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+<script lang="ts">
+  import { setLocale } from '$lib/paraglide/runtime.js'
+  import { AppShell } from '{{fullstack.sharedPackageName}}'
+  import '../app.css'
+
+  const { children } = $props()
+
+  function syncLocale(locale: string) {
+    setLocale(locale as Parameters<typeof setLocale>[0])
+  }
+</script>
+
+<AppShell platform="desktop" onLocaleChange={syncLocale}>
+  {@render children()}
+</AppShell>
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src/routes/+page.svelte.hbs

@@ -0,0 +1,162 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+<script lang="ts">
+  import type { AppInfo } from '{{fullstack.sharedPackageName}}'
+  import * as appM from '$lib/paraglide/messages.js'
+  import { Alert, Button, Card, Skeleton } from '@h-ai/ui'
+  import { onMount } from 'svelte'
+  import { fetchAppInfo, messages as sharedM } from '{{fullstack.sharedPackageName}}'
+
+  let info = $state<AppInfo | null>(null)
+  let loading = $state(true)
+  let errorMessage = $state('')
+
+  async function refreshStatus() {
+    loading = true
+    errorMessage = ''
+    try {
+      info = await fetchAppInfo()
+    }
+    catch {
+      info = null
+      errorMessage = sharedM.home_error()
+    }
+    finally {
+      loading = false
+    }
+  }
+
+  onMount(() => {
+    void refreshStatus()
+  })
+</script>
+
+<svelte:head>
+  <title>{appM.page_title({ name: sharedM.app_name() })}</title>
+</svelte:head>
+
+<section class="space-y-8">
+  <div class="grid gap-6 lg:grid-cols-[1.2fr_0.8fr]">
+    <section class="relative overflow-hidden rounded-[2rem] border border-base-300/70 bg-gradient-to-br from-primary/15 via-base-100 to-secondary/15 p-6 shadow-2xl shadow-primary/10 lg:p-10">
+      <div class="absolute right-8 top-8 hidden size-28 rounded-full bg-primary/20 blur-3xl sm:block"></div>
+      <div class="relative z-10 max-w-2xl space-y-6">
+        <span class="badge badge-primary badge-lg gap-2">
+          <span class="icon-[tabler--rocket] size-4"></span>
+          {appM.hero_badge()}
+        </span>
+        <div class="space-y-4">
+          <h1 class="text-4xl font-black tracking-tight text-base-content sm:text-5xl">
+            {appM.hero_title({ name: sharedM.app_name() })}
+          </h1>
+          <p class="max-w-xl text-lg leading-8 text-base-content/70">
+            {appM.hero_subtitle()}
+          </p>
+        </div>
+        <div class="flex flex-wrap gap-3">
+          <a class="btn btn-primary shadow-lg shadow-primary/20" href="#status">
+            <span class="icon-[tabler--activity-heartbeat] size-5"></span>
+            {appM.hero_primary_action()}
+          </a>
+          <a class="btn btn-ghost" href="#customize">
+            <span class="icon-[tabler--adjustments] size-5"></span>
+            {appM.hero_secondary_action()}
+          </a>
+        </div>
+      </div>
+    </section>
+
+    <aside class="rounded-[2rem] border border-base-300/70 bg-base-100/80 p-5 shadow-xl backdrop-blur">
+      <div class="mockup-window border border-base-300 bg-base-200/70">
+        <div class="space-y-4 bg-base-100 p-5">
+          <div class="flex items-center justify-between">
+            <div>
+              <p class="text-sm font-semibold">{appM.preview_title()}</p>
+              <p class="text-xs text-base-content/55">{appM.preview_body()}</p>
+            </div>
+            <span class="badge badge-success badge-outline">{appM.platform_name()}</span>
+          </div>
+          <div class="grid gap-3 text-sm">
+            <div class="rounded-2xl bg-primary/10 p-4">
+              <span class="icon-[tabler--components] mb-2 size-6 text-primary"></span>
+              <p class="font-semibold">{appM.preview_metric_shared()}</p>
+            </div>
+            <div class="grid grid-cols-2 gap-3">
+              <div class="rounded-2xl bg-secondary/10 p-4">
+                <span class="icon-[tabler--language] mb-2 size-6 text-secondary"></span>
+                <p class="font-semibold">{appM.preview_metric_local()}</p>
+              </div>
+              <div class="rounded-2xl bg-accent/10 p-4">
+                <span class="icon-[tabler--palette] mb-2 size-6 text-accent"></span>
+                <p class="font-semibold">{appM.preview_metric_theme()}</p>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </aside>
+  </div>
+
+  <div class="grid gap-6 lg:grid-cols-[0.95fr_1.05fr]">
+    <div id="status">
+    <Card title={appM.status_title()} bordered shadow="md" class="bg-base-100/90 backdrop-blur">
+      <p class="mb-5 text-sm text-base-content/65">{appM.status_description()}</p>
+      {#if loading}
+        <Skeleton variant="title" class="mb-3" />
+        <Skeleton count={3} />
+        <p class="sr-only" data-testid="service-status">{sharedM.home_loading()}</p>
+      {:else if info}
+        <Alert variant="success" title={appM.status_online({ name: info.name })}>
+          <p data-testid="service-status">{info.name}</p>
+        </Alert>
+        <dl class="mt-5 grid gap-3 sm:grid-cols-2 text-sm">
+          <div class="rounded-box border border-base-300/70 bg-base-200/60 p-4">
+            <dt class="text-xs text-base-content/55">{appM.status_version()}</dt>
+            <dd class="mt-1 font-semibold">{info.version}</dd>
+          </div>
+          <div class="rounded-box border border-base-300/70 bg-base-200/60 p-4">
+            <dt class="text-xs text-base-content/55">{appM.status_started({ time: info.startedAt })}</dt>
+            <dd class="mt-1 font-semibold">{appM.status_frontends_count({ count: String(info.frontends.length) })}</dd>
+          </div>
+          <div class="rounded-box border border-base-300/70 bg-base-200/60 p-4 sm:col-span-2">
+            <dt class="text-xs text-base-content/55">{appM.status_frontends({ list: info.frontends.join(' / ') })}</dt>
+            <dd class="mt-1 font-semibold">{sharedM.home_subtitle()}</dd>
+          </div>
+        </dl>
+      {:else}
+        <Alert variant="error" title={sharedM.home_error()}>
+          <p data-testid="service-status">{errorMessage}</p>
+        </Alert>
+      {/if}
+
+      <div class="mt-5">
+        <Button type="button" variant="primary" loading={loading} onclick={refreshStatus}>
+          {sharedM.home_refresh()}
+        </Button>
+      </div>
+    </Card>
+    </div>
+
+    <section id="customize" class="grid gap-4 sm:grid-cols-2">
+      <div class="rounded-[1.5rem] border border-base-300/70 bg-base-100/90 p-5 shadow-md">
+        <span class="icon-[tabler--package] mb-4 size-7 text-primary"></span>
+        <h2 class="text-lg font-bold">{appM.custom_shared_title()}</h2>
+        <p class="mt-2 text-sm leading-6 text-base-content/65">{appM.custom_shared_body()}</p>
+      </div>
+      <div class="rounded-[1.5rem] border border-base-300/70 bg-base-100/90 p-5 shadow-md">
+        <span class="icon-[tabler--message-language] mb-4 size-7 text-secondary"></span>
+        <h2 class="text-lg font-bold">{appM.custom_local_title()}</h2>
+        <p class="mt-2 text-sm leading-6 text-base-content/65">{appM.custom_local_body()}</p>
+      </div>
+      <div class="rounded-[1.5rem] border border-base-300/70 bg-base-100/90 p-5 shadow-md sm:col-span-2">
+        <h2 class="text-lg font-bold">{appM.flow_title()}</h2>
+        <ol class="mt-4 grid gap-3 md:grid-cols-4">
+          <li class="rounded-box bg-base-200/70 p-4 text-sm">{appM.flow_contract()}</li>
+          <li class="rounded-box bg-base-200/70 p-4 text-sm">{appM.flow_service()}</li>
+          <li class="rounded-box bg-base-200/70 p-4 text-sm">{appM.flow_shared()}</li>
+          <li class="rounded-box bg-base-200/70 p-4 text-sm">{appM.flow_frontend()}</li>
+        </ol>
+      </div>
+    </section>
+  </div>
+</section>
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/svelte.config.js.hbs

@@ -0,0 +1,20 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+import { autoImportHaiUi } from '@h-ai/ui/auto-import'
+import adapter from '@sveltejs/adapter-auto'
+import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+  preprocess: [autoImportHaiUi(), vitePreprocess()],
+  compilerOptions: {
+    // 使用 Svelte 5 Runes，和 @h-ai/ui 组件库保持一致。
+    runes: true,
+  },
+  kit: {
+    adapter: adapter(),
+  },
+}
+
+export default config
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/tests/api.test.ts.hbs

@@ -0,0 +1,28 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+import { fetchAppInfo } from '{{fullstack.sharedPackageName}}'
+import { describe, expect, it } from 'vitest'
+
+describe('fetchAppInfo', () => {
+  it('parses shared contract response', async () => {
+    const fetchFn: typeof fetch = async () => new Response(
+      JSON.stringify({
+        success: true,
+        data: {
+          name: '{{fullstack.servPackageName}}',
+          version: '0.1.0',
+          startedAt: '2026-01-01T00:00:00.000Z',
+          frontends: ['desktop'],
+        },
+      }),
+      {
+        headers: { 'content-type': 'application/json' },
+      },
+    )
+
+    const info = await fetchAppInfo({ fetchFn, baseUrl: 'http://127.0.0.1:3000' })
+
+    expect(info.name).toBe('{{fullstack.servPackageName}}')
+  })
+})
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/tsconfig.json.hbs

@@ -0,0 +1,17 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "extends": "./.svelte-kit/tsconfig.json",
+  "compilerOptions": {
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "allowJs": true,
+    "checkJs": false,
+    "strict": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*", "src/**/*.svelte", "tests/**/*"],
+  "exclude": ["node_modules", ".svelte-kit", "build"]
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/vite.config.ts.hbs

@@ -0,0 +1,29 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+import { paraglideVitePlugin } from '@inlang/paraglide-js'
+import { sveltekit } from '@sveltejs/kit/vite'
+import tailwindcss from '@tailwindcss/vite'
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  plugins: [
+    paraglideVitePlugin({
+      project: './project.inlang',
+      outdir: './src/lib/paraglide',
+      strategy: ['cookie', 'baseLocale'],
+    }),
+    sveltekit(),
+    tailwindcss(),
+  ],
+  optimizeDeps: {
+    exclude: ['bits-ui'],
+  },
+  ssr: {
+    noExternal: [/@h-ai\//, /{{fullstack.sharedPackageName}}/],
+  },
+  test: {
+    environment: 'node',
+    include: ['tests/**/*.test.ts'],
+  },
+})
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-miniapp/README.md.hbs

@@ -0,0 +1,13 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.hasMiniapp}}
+# {{projectName}}-miniapp
+
+小程序端当前为预留占位，不参与 workspace 构建、单元测试或 E2E，但已预置 inlang 标准目录：
+
+- `project.inlang/settings.json`：小程序端 locale 配置
+- `messages/zh-CN.json`、`messages/en-US.json`：小程序端自有文案
+
+后续实现时建议复用 `packages/{{fullstack.contractPackageName}}` 中的 Schema 与路径常量，保持接口真相源一致。
+
+协同边界：跨端通用文案/组件放 `packages/{{fullstack.sharedPackageName}}`，小程序独有页面文案放本目录 `messages/`。
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-miniapp/messages/en-US.json.hbs

@@ -0,0 +1,12 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.hasMiniapp}}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "mini_title": "{{projectName}} Mini App",
+  "mini_status": "Reserved placeholder",
+  "mini_description": "The mini app target does not generate a buildable package yet, but it includes standard inlang project.inlang and messages so a real mini app framework can adopt them later.",
+  "mini_shared_contract": "Reuse Schema and route constants from packages/{{fullstack.contractPackageName}}.",
+  "mini_own_messages": "Mini-app-only copy lives in apps/{{projectName}}-miniapp/messages.",
+  "mini_customize": "Keep locale lists aligned with shared so cross-platform locale switching remains consistent."
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-miniapp/messages/zh-CN.json.hbs

@@ -0,0 +1,12 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.hasMiniapp}}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "mini_title": "{{projectName}} 小程序端",
+  "mini_status": "预留占位",
+  "mini_description": "小程序端暂不生成可构建 package，但已经按 inlang 标准预置 project.inlang 与 messages，后续接入真实小程序框架时可直接迁移。",
+  "mini_shared_contract": "复用 packages/{{fullstack.contractPackageName}} 的 Schema 与路径常量。",
+  "mini_own_messages": "小程序独有文案放在 apps/{{projectName}}-miniapp/messages。",
+  "mini_customize": "保持 locale 列表与 shared 一致，跨端语言切换才能保持同步。"
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-miniapp/project.inlang/settings.json.hbs

@@ -0,0 +1,17 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.hasMiniapp}}
+{
+  "$schema": "https://inlang.com/schema/project-settings",
+  "baseLocale": "{{fullstack.i18n.baseLocale}}",
+  "locales": [
+    {{#each fullstack.i18n.locales}}"{{this}}"{{#unless @last}},{{/unless}}
+    {{/each}}
+  ],
+  "modules": [
+    "https://cdn.jsdelivr.net/npm/@inlang/plugin-message-format@latest/dist/index.js"
+  ],
+  "plugin.inlang.messageFormat": {
+    "pathPattern": "./messages/{locale}.json"
+  }
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/README.md.hbs

@@ -0,0 +1,21 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+# {{projectName}}-web
+
+Web 前端工程，使用 `@h-ai/api-client` 绑定共享 contract 调用后端 API，并通过 `@h-ai/ui` 组件搭建页面。
+
+## i18n 与 shared 协同
+
+- 本端页面文案：`messages/{locale}.json` + `project.inlang/settings.json`
+- 共享 Shell/主题/语言/API：`packages/{{fullstack.sharedPackageName}}`
+- 语言切换由 shared 的 `LanguageSwitcher` 触发，并同步本端 `$lib/paraglide/runtime.js`
+
+自定义建议：Web 独有文案放在本目录 `messages/`；跨端通用文案或组件放到 shared。
+
+## 开发
+
+- `pnpm i18n:compile`：在工作区根目录统一编译 shared + 各前端 Paraglide 输出
+- `pnpm --filter {{projectName}}-web dev`，默认端口 4173
+- `pnpm --filter {{projectName}}-web paraglide:compile`：只编译本端 messages
+- `pnpm --filter {{projectName}}-web test`
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/eslint.config.js.hbs

@@ -0,0 +1,23 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+import antfu from '@antfu/eslint-config'
+
+export default antfu({
+  formatters: true,
+  ignores: ['**/.svelte-kit/**', '**/build/**', '**/dist/**', '**/*.d.ts', '**/project.inlang/**', '**/src/lib/paraglide/**'],
+  svelte: true,
+}, {
+  files: ['**/*.ts', '**/*.svelte'],
+  rules: {
+    'no-console': 'error',
+    'ts/no-explicit-any': 'error',
+  },
+}, {
+  files: ['**/*.svelte'],
+  rules: {
+    'svelte/html-quotes': 'off',
+    'svelte/indent': 'off',
+    'perfectionist/sort-imports': 'off',
+  },
+})
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-web/messages/en-US.json.hbs

@@ -0,0 +1,34 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.web}}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "page_title": "{name} · Web",
+  "platform_name": "Web",
+  "hero_badge": "Web workspace",
+  "hero_title": "{name} Web Console",
+  "hero_subtitle": "A browser-first product landing page. Page copy comes from this app's messages, while shared provides the shell, theme, locale switcher and API client.",
+  "hero_primary_action": "View service status",
+  "hero_secondary_action": "Customize the starter",
+  "preview_title": "Responsive web experience",
+  "preview_body": "Ready for websites, consoles and admin entry points",
+  "preview_metric_shared": "Shared components and API client",
+  "preview_metric_local": "Web-owned messages",
+  "preview_metric_theme": "Configurable themes",
+  "status_title": "Service connectivity",
+  "status_description": "This page calls the backend service to verify contract, service, shared and the Web frontend are wired together.",
+  "status_online": "{name} is connected",
+  "status_version": "Service version",
+  "status_started": "Started at: {time}",
+  "status_frontends": "Service frontends: {list}",
+  "status_frontends_count": "{count} frontend targets",
+  "custom_shared_title": "Shared owns common capabilities",
+  "custom_shared_body": "Put cross-platform shell, theme, locale switching, API client and shared UI in packages/{{projectName}}-shared.",
+  "custom_local_title": "Web owns product copy",
+  "custom_local_body": "Write Web-only page copy in apps/{{projectName}}-web/messages and compile it with this app's project.inlang.",
+  "flow_title": "Collaboration boundary",
+  "flow_contract": "Contract defines API truth",
+  "flow_service": "Service implements business endpoints",
+  "flow_shared": "Shared provides cross-platform UI/API",
+  "flow_frontend": "Web composes pages and local copy"
+}
+{{/if}}