OpenCoworkAI · Sun-sunshine06 · Apr 18, 2026 · Apr 18, 2026 · Apr 18, 2026 · github-actions
diff --git a/apps/desktop/package.json b/apps/desktop/package.json
@@ -16,6 +16,7 @@
     "@open-codesign/artifacts": "workspace:*",
     "@open-codesign/core": "workspace:*",
     "@open-codesign/exporters": "workspace:*",
+    "@open-codesign/i18n": "workspace:*",
     "@open-codesign/providers": "workspace:*",
     "@open-codesign/runtime": "workspace:*",
     "@open-codesign/shared": "workspace:*",

diff --git a/apps/desktop/src/main/index.ts b/apps/desktop/src/main/index.ts
@@ -9,6 +9,7 @@ import { autoUpdater } from 'electron-updater';
 import { scanDesignSystem } from './design-system';
 import { BrowserWindow, app, dialog, ipcMain, shell } from './electron-runtime';
 import { registerExporterIpc } from './exporter-ipc';
+import { registerLocaleIpc } from './locale-ipc';
 import { getLogPath, getLogger, initLogger } from './logger';
 import {
   getApiKeyForProvider,
@@ -32,6 +33,7 @@ function createWindow(): void {
     height: 820,
     minWidth: 960,
     minHeight: 640,
+    autoHideMenuBar: process.platform !== 'darwin',
     titleBarStyle: process.platform === 'darwin' ? 'hiddenInset' : 'default',
     backgroundColor: BRAND.backgroundColor,
     show: false,
@@ -254,6 +256,7 @@ void app.whenReady().then(async () => {
   initLogger();
   await loadConfigOnBoot();
   registerIpcHandlers();
+  registerLocaleIpc();
   registerOnboardingIpc();
   registerExporterIpc(() => mainWindow);
   setupAutoUpdater();

diff --git a/apps/desktop/src/preload/index.ts b/apps/desktop/src/preload/index.ts
@@ -52,6 +52,11 @@ const api = {
     ipcRenderer.invoke('codesign:clear-design-system') as Promise<OnboardingState>,
   export: (payload: { format: ExportFormat; htmlContent: string; defaultFilename?: string }) =>
     ipcRenderer.invoke('codesign:export', payload) as Promise<ExportInvokeResponse>,
+  locale: {
+    getSystem: () => ipcRenderer.invoke('locale:get-system') as Promise<string>,
+    getCurrent: () => ipcRenderer.invoke('locale:get-current') as Promise<string>,
+    set: (locale: string) => ipcRenderer.invoke('locale:set', locale) as Promise<string>,
+  },
   checkForUpdates: () => ipcRenderer.invoke('codesign:check-for-updates'),
   downloadUpdate: () => ipcRenderer.invoke('codesign:download-update'),
   installUpdate: () => ipcRenderer.invoke('codesign:install-update'),

diff --git a/apps/desktop/src/renderer/src/App.tsx b/apps/desktop/src/renderer/src/App.tsx
@@ -1,3 +1,4 @@
+import { useT } from '@open-codesign/i18n';
 import { useEffect, useMemo, useState } from 'react';
 import { CommandPalette } from './components/CommandPalette';
 import { PreviewPane } from './components/PreviewPane';
@@ -10,6 +11,7 @@ import { Onboarding } from './onboarding';
 import { useCodesignStore } from './store';
 
 export function App() {
+  const t = useT();
   const config = useCodesignStore((s) => s.config);
   const configLoaded = useCodesignStore((s) => s.configLoaded);
   const loadConfig = useCodesignStore((s) => s.loadConfig);
@@ -90,7 +92,7 @@ export function App() {
   if (!configLoaded) {
     return (
       <div className="h-full flex items-center justify-center bg-[var(--color-background)] text-[var(--text-sm)] text-[var(--color-text-muted)]">
-        Loading…
+        {t('common.loading')}
       </div>
     );
   }

diff --git a/apps/desktop/src/renderer/src/components/CanvasErrorBar.tsx b/apps/desktop/src/renderer/src/components/CanvasErrorBar.tsx
@@ -1,16 +1,9 @@
-/**
- * CanvasErrorBar — slim red strip shown above the preview iframe when the
- * sandbox runtime postMessages an IFRAME_ERROR.
- *
- * Loud surface (PRINCIPLES §10): every JS exception thrown inside the
- * generated HTML lands here with file + line. Users can dismiss the bar
- * (it clears the store slice) but errors are never auto-hidden.
- */
-
+import { useT } from '@open-codesign/i18n';
 import { X } from 'lucide-react';
 import { useCodesignStore } from '../store';
 
 export function CanvasErrorBar() {
+  const t = useT();
   const errors = useCodesignStore((s) => s.iframeErrors);
   const clear = useCodesignStore((s) => s.clearIframeErrors);
   if (errors.length === 0) return null;
@@ -24,7 +17,8 @@ export function CanvasErrorBar() {
       <span className="mt-0.5 inline-block w-2 h-2 rounded-full bg-[var(--color-error)] shrink-0" />
       <div className="flex-1 min-w-0">
         <div className="text-xs font-semibold uppercase tracking-wide text-[var(--color-error)]">
-          Preview runtime error{errors.length > 1 ? ` (${errors.length})` : ''}
+          {t('preview.runtimeError')}
+          {errors.length > 1 ? ` (${errors.length})` : ''}
         </div>
         <div className="text-sm text-[var(--color-text-primary)] truncate" title={latest}>
           {latest}
@@ -33,7 +27,7 @@ export function CanvasErrorBar() {
       <button
         type="button"
         onClick={clear}
-        aria-label="Dismiss preview errors"
+        aria-label={t('preview.dismissErrors')}
         className="shrink-0 p-1 rounded-[var(--radius-md)] text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-surface-hover)] transition-colors"
       >
         <X className="w-4 h-4" />

diff --git a/apps/desktop/src/renderer/src/components/CommandPalette.tsx b/apps/desktop/src/renderer/src/components/CommandPalette.tsx
@@ -1,3 +1,4 @@
+import { useT } from '@open-codesign/i18n';
 import { Download, Moon, Plus, Settings as SettingsIcon } from 'lucide-react';
 import { useEffect, useMemo, useState } from 'react';
 import { useCodesignStore } from '../store';
@@ -11,6 +12,7 @@ interface PaletteAction {
 }
 
 export function CommandPalette() {
+  const t = useT();
   const open = useCodesignStore((s) => s.commandPaletteOpen);
   const close = useCodesignStore((s) => s.closeCommandPalette);
   const openSettings = useCodesignStore((s) => s.openSettings);
@@ -24,8 +26,8 @@ export function CommandPalette() {
     () => [
       {
         id: 'new-design',
-        label: 'New Design',
-        hint: 'Clear chat and start fresh',
+        label: t('commands.items.newDesign'),
+        hint: t('commands.hints.newDesign'),
         icon: Plus,
         run: () => {
           useCodesignStore.setState({
@@ -35,44 +37,44 @@ export function CommandPalette() {
             iframeErrors: [],
             selectedElement: null,
           });
-          pushToast({ variant: 'info', title: 'Workspace cleared' });
+          pushToast({ variant: 'info', title: t('commands.cleared') });
         },
       },
       {
         id: 'toggle-theme',
-        label: 'Toggle Theme',
-        hint: 'Switch between light and dark',
+        label: t('commands.items.toggleTheme'),
+        hint: t('commands.hints.toggleTheme'),
         icon: Moon,
         run: toggleTheme,
       },
       {
         id: 'open-settings',
-        label: 'Open Settings',
-        hint: 'Models, appearance, storage',
+        label: t('commands.items.openSettings'),
+        hint: t('commands.hints.openSettings'),
         icon: SettingsIcon,
         run: openSettings,
       },
       {
         id: 'export',
-        label: 'Export',
-        hint: 'PDF and PPTX coming soon',
+        label: t('commands.items.export'),
+        hint: t('commands.hints.export'),
         icon: Download,
         run: () =>
           pushToast({
             variant: 'info',
-            title: 'Export not available yet',
-            description: 'PDF and PPTX exporters land in v0.2. HTML export is in the toolbar.',
+            title: t('commands.exportUseToolbarTitle'),
+            description: t('commands.exportUseToolbarBody'),
           }),
       },
     ],
-    [openSettings, toggleTheme, pushToast],
+    [openSettings, pushToast, t, toggleTheme],
   );
 
   const filtered = useMemo(() => {
     const q = query.trim().toLowerCase();
     if (!q) return actions;
     return actions.filter(
-      (a) => a.label.toLowerCase().includes(q) || a.hint.toLowerCase().includes(q),
+      (action) => action.label.toLowerCase().includes(q) || action.hint.toLowerCase().includes(q),
     );
   }, [actions, query]);
 
@@ -89,8 +91,8 @@ export function CommandPalette() {
 
   if (!open) return null;
 
-  function runAt(i: number) {
-    const action = filtered[i];
+  function runAt(index: number) {
+    const action = filtered[index];
     if (!action) return;
     action.run();
     close();
@@ -101,7 +103,7 @@ export function CommandPalette() {
       // biome-ignore lint/a11y/useSemanticElements: native <dialog> top-layer rendering interferes with our overlay stack
       role="dialog"
       aria-modal="true"
-      aria-label="Command palette"
+      aria-label={t('commands.title')}
       className="fixed inset-0 z-50 flex items-start justify-center pt-24 px-6 bg-[var(--color-overlay)] animate-[overlay-in_120ms_ease-out]"
       onClick={close}
       onKeyDown={(e) => {
@@ -114,10 +116,10 @@ export function CommandPalette() {
         onKeyDown={(e) => {
           if (e.key === 'ArrowDown') {
             e.preventDefault();
-            setCursor((c) => Math.min(c + 1, filtered.length - 1));
+            setCursor((current) => Math.min(current + 1, filtered.length - 1));
           } else if (e.key === 'ArrowUp') {
             e.preventDefault();
-            setCursor((c) => Math.max(c - 1, 0));
+            setCursor((current) => Math.max(current - 1, 0));
           } else if (e.key === 'Enter') {
             e.preventDefault();
             runAt(cursor);
@@ -136,24 +138,24 @@ export function CommandPalette() {
             setQuery(e.target.value);
             setCursor(0);
           }}
-          placeholder="Type a command…"
+          placeholder={t('commands.placeholder')}
           className="w-full px-5 h-12 bg-transparent border-b border-[var(--color-border)] text-[var(--text-sm)] text-[var(--color-text-primary)] placeholder:text-[var(--color-text-muted)] focus:outline-none"
         />
         <ul className="max-h-72 overflow-y-auto py-2">
           {filtered.length === 0 ? (
             <li className="px-5 py-3 text-[var(--text-sm)] text-[var(--color-text-muted)]">
-              No matches.
+              {t('commands.noMatches')}
             </li>
           ) : (
-            filtered.map((a, i) => {
-              const Icon = a.icon;
-              const active = i === cursor;
+            filtered.map((action, index) => {
+              const Icon = action.icon;
+              const active = index === cursor;
               return (
-                <li key={a.id}>
+                <li key={action.id}>
                   <button
                     type="button"
-                    onMouseEnter={() => setCursor(i)}
-                    onClick={() => runAt(i)}
+                    onMouseEnter={() => setCursor(index)}
+                    onClick={() => runAt(index)}
                     className={`w-full flex items-center gap-3 px-5 py-2.5 text-left transition-colors ${
                       active
                         ? 'bg-[var(--color-surface-active)]'
@@ -163,10 +165,10 @@ export function CommandPalette() {
                     <Icon className="w-4 h-4 text-[var(--color-text-secondary)] shrink-0" />
                     <span className="flex-1 min-w-0">
                       <span className="block text-[var(--text-sm)] text-[var(--color-text-primary)]">
-                        {a.label}
+                        {action.label}
                       </span>
                       <span className="block text-[var(--text-xs)] text-[var(--color-text-muted)]">
-                        {a.hint}
+                        {action.hint}
                       </span>
                     </span>
                   </button>

diff --git a/apps/desktop/src/renderer/src/components/InlineCommentComposer.tsx b/apps/desktop/src/renderer/src/components/InlineCommentComposer.tsx
@@ -1,3 +1,4 @@
+import { useT } from '@open-codesign/i18n';
 import type { SelectedElement } from '@open-codesign/shared';
 import { MessageSquareText, X } from 'lucide-react';
 import { useState } from 'react';
@@ -16,6 +17,7 @@ interface InlineCommentComposerCardProps {
 }
 
 function InlineCommentComposerCard({ selectedElement }: InlineCommentComposerCardProps) {
+  const t = useT();
   const clearCanvasElement = useCodesignStore((s) => s.clearCanvasElement);
   const applyInlineComment = useCodesignStore((s) => s.applyInlineComment);
   const isGenerating = useCodesignStore((s) => s.isGenerating);
@@ -27,7 +29,7 @@ function InlineCommentComposerCard({ selectedElement }: InlineCommentComposerCar
         <div className="min-w-0">
           <div className="inline-flex items-center gap-2 text-[12px] font-medium text-[var(--color-text-primary)]">
             <MessageSquareText className="h-4 w-4 text-[var(--color-accent)]" />
-            Comment on <code className="text-[11px]">{selectedElement.tag}</code>
+            {t('inlineComment.title')} <code className="text-[11px]">{selectedElement.tag}</code>
           </div>
           <p
             className="mt-1 truncate text-[11px] text-[var(--color-text-muted)]"
@@ -40,21 +42,20 @@ function InlineCommentComposerCard({ selectedElement }: InlineCommentComposerCar
           type="button"
           onClick={clearCanvasElement}
           className="rounded-[var(--radius-md)] p-1 text-[var(--color-text-muted)] transition-colors hover:bg-[var(--color-surface-hover)] hover:text-[var(--color-text-primary)]"
-          aria-label="Close inline comment composer"
+          aria-label={t('inlineComment.closeComposer')}
         >
           <X className="h-4 w-4" />
         </button>
       </div>
 
       <div className="space-y-3 p-4">
         <p className="text-[12px] leading-[1.5] text-[var(--color-text-secondary)]">
-          Clicked elements stay selected in the canvas. Describe the visual or content change you
-          want, and open-codesign will rewrite the artifact around that target.
+          {t('inlineComment.description')}
         </p>
         <textarea
           value={draft}
           onChange={(e) => setDraft(e.target.value)}
-          placeholder="Make this section more compact, sharpen the headline, and align it with the linked design system..."
+          placeholder={t('inlineComment.placeholder')}
           rows={4}
           disabled={isGenerating}
           className="w-full resize-none rounded-[var(--radius-lg)] border border-[var(--color-border)] bg-[var(--color-background)] px-3 py-2 text-[13px] leading-[1.5] text-[var(--color-text-primary)] placeholder:text-[var(--color-text-muted)] transition-[box-shadow,border-color] duration-150 focus:border-[var(--color-accent)] focus:shadow-[0_0_0_3px_var(--color-focus-ring)] focus:outline-none"
@@ -65,15 +66,15 @@ function InlineCommentComposerCard({ selectedElement }: InlineCommentComposerCar
             onClick={clearCanvasElement}
             className="text-[12px] text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)]"
           >
-            Cancel
+            {t('common.cancel')}
           </button>
           <button
             type="button"
             disabled={!draft.trim() || isGenerating}
             onClick={() => void applyInlineComment(draft)}
             className="inline-flex items-center justify-center rounded-[var(--radius-md)] bg-[var(--color-accent)] px-3 py-2 text-[12px] font-medium text-white shadow-[var(--shadow-soft)] transition-colors hover:bg-[var(--color-accent-hover)] disabled:pointer-events-none disabled:opacity-40"
           >
-            {isGenerating ? 'Applying...' : 'Apply change'}
+            {isGenerating ? t('inlineComment.applying') : t('inlineComment.applyChange')}
           </button>
         </div>
       </div>

diff --git a/apps/desktop/src/renderer/src/components/LanguageToggle.tsx b/apps/desktop/src/renderer/src/components/LanguageToggle.tsx
@@ -0,0 +1,41 @@
+import { setLocale as applyLocale, getCurrentLocale, useT } from '@open-codesign/i18n';
+import type { Locale } from '@open-codesign/i18n';
+import { Globe } from 'lucide-react';
+import { useEffect, useState } from 'react';
+
+function nextLocale(locale: Locale): Locale {
+  return locale === 'en' ? 'zh-CN' : 'en';
+}
+
+function localeLabel(locale: Locale): string {
+  return locale === 'zh-CN' ? 'ZH' : 'EN';
+}
+
+export function LanguageToggle() {
+  const t = useT();
+  const [locale, setLocaleState] = useState<Locale>(getCurrentLocale());
+
+  useEffect(() => {
+    setLocaleState(getCurrentLocale());
+  }, []);
+
+  async function handleToggle(): Promise<void> {
+    const target = nextLocale(locale);
+    const persisted = window.codesign ? await window.codesign.locale.set(target) : target;
+    const applied = await applyLocale(persisted);
+    setLocaleState(applied);
+  }
+
+  return (
+    <button
+      type="button"
+      onClick={() => void handleToggle()}
+      className="inline-flex items-center gap-2 h-8 px-3 rounded-[var(--radius-md)] border border-[var(--color-border)] bg-[var(--color-surface)] text-[12px] text-[var(--color-text-primary)] hover:bg-[var(--color-surface-hover)] transition-colors"
+      aria-label={t('settings.language.label')}
+      title={t('settings.language.label')}
+    >
+      <Globe className="w-3.5 h-3.5 text-[var(--color-text-secondary)]" />
+      <span>{localeLabel(locale)}</span>
+    </button>
+  );
+}
diff --git a/apps/desktop/src/renderer/src/components/PreviewPane.tsx b/apps/desktop/src/renderer/src/components/PreviewPane.tsx
@@ -1,3 +1,4 @@
+import { useT } from '@open-codesign/i18n';
 import { buildSrcdoc, isIframeErrorMessage, isOverlayMessage } from '@open-codesign/runtime';
 import { useEffect, useRef } from 'react';
 import { EmptyState } from '../preview/EmptyState';
@@ -20,6 +21,7 @@ export function isTrustedPreviewMessageSource(
 }
 
 export function PreviewPane({ onPickStarter }: PreviewPaneProps) {
+  const t = useT();
   const previewHtml = useCodesignStore((s) => s.previewHtml);
   const isGenerating = useCodesignStore((s) => s.isGenerating);
   const errorMessage = useCodesignStore((s) => s.errorMessage);
@@ -74,7 +76,7 @@ export function PreviewPane({ onPickStarter }: PreviewPaneProps) {
       <div className="h-full p-6">
         <div className="relative h-full">
           <div className="absolute left-5 top-5 z-10 rounded-full border border-[var(--color-border)] bg-[rgba(255,255,255,0.88)] px-3 py-1 text-[11px] text-[var(--color-text-secondary)] shadow-[var(--shadow-soft)] backdrop-blur">
-            Click any element in the preview to leave an inline comment.
+            {t('preview.clickToComment')}
           </div>
           <iframe
             ref={iframeRef}