xertica-ui 2.3.0 → 2.4.1

package/CHANGELOG.md

@@ -11,6 +11,26 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [2.4.1] — 2026-06-17
+
+### Changed
+
+- **StatsCard — Cores de ícone customizáveis** — Adicionadas as propriedades `iconColor` e `iconBg` ao `StatsCard`, permitindo customizar a cor do ícone e o fundo do ícone (que anteriormente eram fixos em `text-muted-foreground` e `bg-muted`). Documentação e histórias do Storybook foram atualizadas correspondendo a essas propriedades.
+
+---
+
+## [2.4.0] — 2026-06-16
+
+### Added
+
+- **CLI — Ativação/Desativação de Dark Mode** — nova funcionalidade no CLI para ativar ou desativar o dark mode ao criar (`init`) ou atualizar (`update`) o projeto. A escolha do usuário é armazenada em `.xertica.json` na raiz e gera `disableDarkMode={true}` dentro do `<XerticaProvider>` em `App.tsx`. O botão `ThemeToggle` e a aba de switch de temas nas configurações ocultam-se automaticamente caso o dark mode esteja desativado.
+
+### Fixed
+
+- **Layout — Correção do scroll vertical** — ajustado o comportamento do scroll vertical para travar o viewport com `h-screen overflow-hidden` em `App.tsx` e `AuthGuard.tsx`, bem como `height: 100%; overflow: hidden` no `html, body` em `index.css` e `base.css`. Páginas de autenticação (como login, recuperação de senha, etc.) agora possuem rolagem interna (`h-full overflow-y-auto`), impedindo que o scroll global suba/desloque o cabeçalho (`Header`) e o assistente virtual.
+
+---
+
 ## [2.3.0] — 2026-06-15
 
 ### Added
@@ -81,11 +101,11 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - **CLI Initialization** — Correções essenciais no comando `init`:
   - `i18n.ts` e o diretório `locales/` agora são copiados corretamente, restaurando as traduções na aplicação gerada.
   - `AuthContext.tsx` e dependências agora são incluídas, habilitando o hook `useAuth`.
-  - A geração do `AuthGuard.tsx` foi reconstruída de forma dinâmica para consumir corretamente o `useAuth()` e garantir integridade das rotas protegidas e abertas, suportando *lazy loading* dinâmico das rotas de acordo com a seleção do usuário.
+  - A geração do `AuthGuard.tsx` foi reconstruída de forma dinâmica para consumir corretamente o `useAuth()` e garantir integridade das rotas protegidas e abertas, suportando _lazy loading_ dinâmico das rotas de acordo com a seleção do usuário.
   - O diretório `features/assistant/` agora é sempre copiado visto que o `AppLayout` depende nativamente da `AssistantPage`.
 - **Template Lints** — Resolução de diversos `unused-vars` (variáveis e imports órfãos) espalhados pelo `HomeContent.tsx`, `TemplateContent.tsx`, `AssistantPage.tsx` e `AuthContext.tsx`, garantindo que o `npm run check` (`tsc` + `eslint`) execute com 100% de sucesso imediatamente após a geração do projeto.
 - **`LanguageSelector` e `LanguageContext`** — Correção de bugs na seleção de idiomas e fallback:
-  - `LanguageContext.tsx` agora valida de forma robusta e intercepta valores legados como `'PT'` no `localStorage`, realizando um *fallback* seguro para `'pt-BR'`.
+  - `LanguageContext.tsx` agora valida de forma robusta e intercepta valores legados como `'PT'` no `localStorage`, realizando um _fallback_ seguro para `'pt-BR'`.
   - O componente `LanguageSelector.tsx` foi ajustado na sua composição com Radix UI: a dependência restritiva do `<SelectValue>` foi removida no trigger, evitando a sobrescrita do conteúdo. Agora o componente exibe a variante `minimal` (como `PT`, `EN`, `ES`) perfeitamente, sincronizada com o estado global de tradução.
 
 ---

package/README.md

@@ -2,7 +2,7 @@
 
 > **Enterprise-grade React design system** built on Tailwind CSS v4, Radix UI, and Lucide Icons — with a robust AI-first documentation layer for precise LLM-driven composition and autonomous agent interaction.
 
-[![npm version](https://img.shields.io/badge/npm-2.3.0-blue)](https://www.npmjs.com/package/xertica-ui)
+[![npm version](https://img.shields.io/badge/npm-2.4.1-blue)](https://www.npmjs.com/package/xertica-ui)
 [![license](https://img.shields.io/badge/license-proprietary-red)](./LICENSE)
 
 ---
@@ -32,21 +32,22 @@ npm run dev
 
 During `init`, the CLI walks you through:
 
-| Prompt | Choices |
-|---|---|
-| Pages to include | Login, Home, Template (multi-select) |
-| **Languages to support** | Português (BR), English, Español — select **1, 2, or 3** |
-| Default color theme | Xertica, Slate, Blue, Violet, Rose, Emerald, … |
-| **Include AI Assistant** | yes (default) / no |
-| Install dependencies automatically | yes / no |
+| Prompt                             | Choices                                                  |
+| ---------------------------------- | -------------------------------------------------------- |
+| Pages to include                   | Login, Home, Template (multi-select)                     |
+| **Languages to support**           | Português (BR), English, Español — select **1, 2, or 3** |
+| Default color theme                | Xertica, Slate, Blue, Violet, Rose, Emerald, …           |
+| **Enable dark mode support?**      | yes (default) / no                                       |
+| **Include AI Assistant**           | yes (default) / no                                       |
+| Install dependencies automatically | yes / no                                                 |
 
 The CLI generates a tailored project with:
 
 - Only the locale JSON files for the languages you picked (no orphan files)
 - `src/i18n.ts` with imports + `resources` for exactly those languages
-- `src/app/App.tsx` with the `availableLanguages` prop on `<XerticaProvider>` (omitted when all 3 defaults are selected)
+- `src/app/App.tsx` with the `availableLanguages` prop on `<XerticaProvider>` (omitted when all 3 defaults are selected) and `disableDarkMode={true}` if dark mode support was disabled
 - A persisted selection in `src/locales/.languages.json` so the `update` command can preserve it
-- Feature flags in `.xertica.json` (e.g. `hasAssistant`) so the `update` command can read the current state
+- Feature flags in `.xertica.json` (e.g. `hasAssistant`, `disableDarkMode`) so the `update` command can read the current state
 
 ### Monolingual mode (transparent)
 
@@ -59,6 +60,7 @@ npx xertica-ui update      # then choose "Languages"
 ```
 
 The flow shows your current selection, lets you toggle languages, and on confirmation:
+
 - copies any newly-added locale JSON from `node_modules/xertica-ui/templates/src/locales/`
 - removes JSONs of unselected languages
 - regenerates `src/i18n.ts` and `src/app/App.tsx`
@@ -66,6 +68,14 @@ The flow shows your current selection, lets you toggle languages, and on confirm
 
 The `update` → **Project files** flow also reads `.languages.json` and preserves your selection — overwrites of `App.tsx` and `i18n.ts` won't reset your languages to defaults.
 
+### Enabling or disabling Dark Mode support later
+
+```bash
+npx xertica-ui update      # then choose "Dark Mode"
+```
+
+The flow detects the current state (via `.xertica.json`) and prompts you to enable or disable dark mode. On confirmation, it updates `.xertica.json` and regenerates `App.tsx` with the updated `disableDarkMode` flag (which hides the `ThemeToggle` and template settings tab switch when disabled).
+
 ### Adding or removing the AI Assistant later
 
 ```bash
@@ -73,6 +83,7 @@ npx xertica-ui update      # then choose "Assistant"
 ```
 
 The flow detects the current state (via `.xertica.json` or file presence) and shows the appropriate action:
+
 - **Add**: copies `src/features/assistant/` and `src/pages/AssistantPage.tsx`, adds the `/assistente` route to `AuthGuard.tsx`, and updates `HomePage.tsx` / `TemplatePage.tsx` to include the assistant panel.
 - **Remove**: deletes those files, removes the route, and regenerates the page files without assistant imports.
 
@@ -278,22 +289,22 @@ Each feature only imports from `shared/` or its own domain. Pages only compose f
 
 ### Composed Blocks (with matching skeleton variants)
 
-| Card | Skeleton |
-|---|---|
-| `FeatureCard` | `FeatureCardSkeleton` |
-| `ActivityCard` | `ActivityCardSkeleton` |
-| `ProfileCard` | `ProfileCardSkeleton` |
-| `ProjectCard` | `ProjectCardSkeleton` |
-| `QuickActionCard` | `QuickActionCardSkeleton` |
-| `NotificationCard` | `NotificationCardSkeleton` |
-| `StatsCard` (in `xertica-ui/ui`) | `StatsCardSkeleton` |
+| Card                             | Skeleton                   |
+| -------------------------------- | -------------------------- |
+| `FeatureCard`                    | `FeatureCardSkeleton`      |
+| `ActivityCard`                   | `ActivityCardSkeleton`     |
+| `ProfileCard`                    | `ProfileCardSkeleton`      |
+| `ProjectCard`                    | `ProjectCardSkeleton`      |
+| `QuickActionCard`                | `QuickActionCardSkeleton`  |
+| `NotificationCard`               | `NotificationCardSkeleton` |
+| `StatsCard` (in `xertica-ui/ui`) | `StatsCardSkeleton`        |
 
 Each skeleton mirrors its card's visual layout with pulsing placeholders for loading states:
 
 ```tsx
-{isLoading
-  ? <ActivityCardSkeleton rows={5} />
-  : <ActivityCard items={items} />}
+{
+  isLoading ? <ActivityCardSkeleton rows={5} /> : <ActivityCard items={items} />;
+}
 ```
 
 ---

package/bin/cli.ts

@@ -29,21 +29,28 @@ const XERTICA_CONFIG_FILE = '.xertica.json';
 interface XerticaConfig {
   version: 1;
   hasAssistant: boolean;
+  disableDarkMode?: boolean;
 }
 
 async function readXerticaConfig(targetDir: string): Promise<XerticaConfig | null> {
   const configPath = path.join(targetDir, XERTICA_CONFIG_FILE);
   if (!(await fs.pathExists(configPath))) return null;
   try {
-    return await fs.readJson(configPath) as XerticaConfig;
+    return (await fs.readJson(configPath)) as XerticaConfig;
   } catch {
     return null;
   }
 }
 
-async function writeXerticaConfig(targetDir: string, config: Partial<XerticaConfig>): Promise<void> {
+async function writeXerticaConfig(
+  targetDir: string,
+  config: Partial<XerticaConfig>
+): Promise<void> {
   const configPath = path.join(targetDir, XERTICA_CONFIG_FILE);
-  const existing = (await readXerticaConfig(targetDir)) ?? { version: 1 as const, hasAssistant: false };
+  const existing = (await readXerticaConfig(targetDir)) ?? {
+    version: 1 as const,
+    hasAssistant: false,
+  };
   await fs.writeJson(configPath, { ...existing, ...config, version: 1 }, { spaces: 2 });
 }
 
@@ -80,10 +87,14 @@ import { useAuth } from '../context/AuthContext';
 
 // ─── Lazy page imports ────────────────────────────────────────────────────────
 
-${hasLogin ? `const LoginPage = React.lazy(() => import('../../pages/LoginPage').then(m => ({ default: m.LoginPage })));
+${
+  hasLogin
+    ? `const LoginPage = React.lazy(() => import('../../pages/LoginPage').then(m => ({ default: m.LoginPage })));
 const ForgotPasswordPage = React.lazy(() => import('../../pages/ForgotPasswordPage').then(m => ({ default: m.ForgotPasswordPage })));
 const VerifyEmailPage = React.lazy(() => import('../../pages/VerifyEmailPage').then(m => ({ default: m.VerifyEmailPage })));
-const ResetPasswordPage = React.lazy(() => import('../../pages/ResetPasswordPage').then(m => ({ default: m.ResetPasswordPage })));` : ''}
+const ResetPasswordPage = React.lazy(() => import('../../pages/ResetPasswordPage').then(m => ({ default: m.ResetPasswordPage })));`
+    : ''
+}
 
 ${hasHome ? `const HomePage = React.lazy(() => import('../../pages/HomePage').then(m => ({ default: m.HomePage })));` : ''}
 ${hasTemplate ? `const TemplatePage = React.lazy(() => import('../../pages/TemplatePage').then(m => ({ default: m.TemplatePage })));` : ''}
@@ -98,7 +109,9 @@ function ProtectedRoute({ children }: { children: React.ReactNode }) {
   return <>{children}</>;
 }
 
-${hasLogin ? `function GuestRoute({ children }: { children: React.ReactNode }) {
+${
+  hasLogin
+    ? `function GuestRoute({ children }: { children: React.ReactNode }) {
   const { user, isLoading } = useAuth();
   if (isLoading) return null;
   if (user) return <Navigate to="${firstProtectedPath}" replace />;
@@ -108,7 +121,9 @@ ${hasLogin ? `function GuestRoute({ children }: { children: React.ReactNode }) {
 function LoginPageWithAuth() {
   const { login } = useAuth();
   return <LoginPage onLogin={login} />;
-}` : ''}
+}`
+    : ''
+}
 
 // ─── Route tree ───────────────────────────────────────────────────────────────
 
@@ -118,10 +133,14 @@ export function AuthGuard() {
   return (
     <div className="min-h-screen bg-muted overflow-x-hidden max-w-full">
       <Routes>
-${hasLogin ? `        <Route path="/login" element={<GuestRoute><LoginPageWithAuth /></GuestRoute>} />
+${
+  hasLogin
+    ? `        <Route path="/login" element={<GuestRoute><LoginPageWithAuth /></GuestRoute>} />
         <Route path="/forgot-password" element={<GuestRoute><ForgotPasswordPage /></GuestRoute>} />
         <Route path="/verify-email" element={<GuestRoute><VerifyEmailPage /></GuestRoute>} />
-        <Route path="/reset-password" element={<GuestRoute><ResetPasswordPage /></GuestRoute>} />` : ''}
+        <Route path="/reset-password" element={<GuestRoute><ResetPasswordPage /></GuestRoute>} />`
+    : ''
+}
 
 ${hasHome ? `        <Route path="/home" element={<ProtectedRoute><HomePage /></ProtectedRoute>} />` : ''}
 ${hasTemplate ? `        <Route path="/template" element={<ProtectedRoute><TemplatePage /></ProtectedRoute>} />` : ''}
@@ -326,6 +345,12 @@ program
         message: 'Include AI Assistant? (XerticaAssistant chat page + sidebar variant)',
         initial: true,
       },
+      {
+        type: 'confirm',
+        name: 'enableDarkMode',
+        message: 'Enable dark mode support?',
+        initial: true,
+      },
       {
         type: 'confirm',
         name: 'install',
@@ -392,12 +417,14 @@ program
         path.join(targetDir, 'src', 'main.tsx')
       );
 
+      const disableDarkMode = response.enableDarkMode === false;
+
       // 4. Generate src/app/App.tsx with the user's language selection
       //    (instead of copying the static template, we inject `availableLanguages`)
       await fs.ensureDir(path.join(targetDir, 'src', 'app'));
       await fs.writeFile(
         path.join(targetDir, 'src', 'app', 'App.tsx'),
-        generateAppTsx(selectedLanguages)
+        generateAppTsx(selectedLanguages, disableDarkMode)
       );
 
       // 5. Copy src/app/components/AppLayout.tsx (always needed)
@@ -426,7 +453,7 @@ program
       await writeLanguagesConfig(targetDir, selectedLanguages);
 
       // 6.5 Persist project feature flags (.xertica.json)
-      await writeXerticaConfig(targetDir, { hasAssistant });
+      await writeXerticaConfig(targetDir, { hasAssistant, disableDarkMode });
 
       // 6.4 Copy context
       await fs.ensureDir(path.join(targetDir, 'src', 'app', 'context'));
@@ -501,7 +528,13 @@ program
 
       // 9. Generate AuthGuard.tsx based on selected pages
       const firstProtectedPath = hasHome ? '/home' : hasTemplate ? '/template' : '/login';
-      const authGuardContent = generateAuthGuard({ hasLogin, hasHome, hasTemplate, hasAssistant, firstProtectedPath });
+      const authGuardContent = generateAuthGuard({
+        hasLogin,
+        hasHome,
+        hasTemplate,
+        hasAssistant,
+        firstProtectedPath,
+      });
 
       await fs.writeFile(
         path.join(targetDir, 'src', 'app', 'components', 'AuthGuard.tsx'),
@@ -543,9 +576,7 @@ program
           `  Languages: ${langLabels}${selectedLanguages.length === 1 ? ' (monolingual — LanguageSelector hidden)' : ''}`
         )
       );
-      console.log(
-        chalk.gray('  To add/remove languages later: npx xertica-ui update → Languages')
-      );
+      console.log(chalk.gray('  To add/remove languages later: npx xertica-ui update → Languages'));
       console.log(
         chalk.gray(`  AI Assistant: ${hasAssistant ? 'included (/assistente)' : 'not included'}`)
       );
@@ -591,6 +622,13 @@ program
             : 'Add the AI Assistant to your project',
           value: 'assistant',
         },
+        {
+          title: 'Dark Mode',
+          description: currentConfig?.disableDarkMode
+            ? 'Enable dark mode support in your project'
+            : 'Disable dark mode support in your project',
+          value: 'darkmode',
+        },
         {
           title: 'Project files',
           description: 'Update app shell, shared, features and pages to a specific version',
@@ -657,9 +695,11 @@ program
 
       console.log(
         chalk.cyan(
-          `\nCurrent languages: ${SUPPORTED_LANGUAGES.filter(l => currentCodes.includes(l.code))
-            .map(l => l.label)
-            .join(', ') || '(none)'}\n`
+          `\nCurrent languages: ${
+            SUPPORTED_LANGUAGES.filter(l => currentCodes.includes(l.code))
+              .map(l => l.label)
+              .join(', ') || '(none)'
+          }\n`
         )
       );
 
@@ -692,10 +732,8 @@ program
       }
 
       const summary: string[] = [];
-      if (toAdd.length > 0)
-        summary.push(chalk.green(`  + ${toAdd.join(', ')}`));
-      if (toRemove.length > 0)
-        summary.push(chalk.red(`  - ${toRemove.join(', ')}`));
+      if (toAdd.length > 0) summary.push(chalk.green(`  + ${toAdd.join(', ')}`));
+      if (toRemove.length > 0) summary.push(chalk.red(`  - ${toRemove.join(', ')}`));
       console.log(`\n${summary.join('\n')}\n`);
 
       const { confirmed } = await prompts({
@@ -728,23 +766,17 @@ program
           : path.resolve(__dirname, '../templates');
 
         // 1) Sync locale JSON files: copy newly-added, prune removed
-        const { copied, removed } = await syncLocaleFiles(
-          templatesSourceDir,
-          targetDir,
-          newCodes,
-          { pruneOthers: true }
-        );
+        const { copied, removed } = await syncLocaleFiles(templatesSourceDir, targetDir, newCodes, {
+          pruneOthers: true,
+        });
 
         // 2) Regenerate i18n.ts so imports/resources reflect the new set
-        await fs.writeFile(
-          path.join(targetDir, 'src', 'i18n.ts'),
-          generateI18nFile(newCodes)
-        );
+        await fs.writeFile(path.join(targetDir, 'src', 'i18n.ts'), generateI18nFile(newCodes));
 
         // 3) Regenerate App.tsx so the `availableLanguages` prop matches
         await fs.writeFile(
           path.join(targetDir, 'src', 'app', 'App.tsx'),
-          generateAppTsx(newCodes)
+          generateAppTsx(newCodes, currentConfig?.disableDarkMode ?? false)
         );
 
         // 4) Persist the new selection
@@ -756,9 +788,7 @@ program
         if (removed.length > 0) console.log(chalk.red(`  Removed: ${removed.join(', ')}`));
         if (newCodes.length === 1) {
           console.log(
-            chalk.gray(
-              `  Project is now monolingual — the LanguageSelector will auto-hide.`
-            )
+            chalk.gray(`  Project is now monolingual — the LanguageSelector will auto-hide.`)
           );
         }
       } catch (error) {
@@ -798,11 +828,19 @@ program
           : 'Add the AI Assistant to your project?',
         choices: currentlyHas
           ? [
-              { title: 'Remove assistant', description: 'Deletes AssistantPage and assistant feature files', value: 'remove' },
+              {
+                title: 'Remove assistant',
+                description: 'Deletes AssistantPage and assistant feature files',
+                value: 'remove',
+              },
               { title: 'Cancel', value: 'cancel' },
             ]
           : [
-              { title: 'Add assistant', description: 'Copies AssistantPage and assistant feature files', value: 'add' },
+              {
+                title: 'Add assistant',
+                description: 'Copies AssistantPage and assistant feature files',
+                value: 'add',
+              },
               { title: 'Cancel', value: 'cancel' },
             ],
       });
@@ -828,10 +866,17 @@ program
         return;
       }
 
-      const spinner = ora(action === 'add' ? 'Adding assistant...' : 'Removing assistant...').start();
+      const spinner = ora(
+        action === 'add' ? 'Adding assistant...' : 'Removing assistant...'
+      ).start();
 
       try {
-        const installedTemplatesDir = path.join(targetDir, 'node_modules', 'xertica-ui', 'templates');
+        const installedTemplatesDir = path.join(
+          targetDir,
+          'node_modules',
+          'xertica-ui',
+          'templates'
+        );
         const templatesSourceDir = (await fs.pathExists(installedTemplatesDir))
           ? installedTemplatesDir
           : path.resolve(__dirname, '../templates');
@@ -917,6 +962,51 @@ program
       return;
     }
 
+    // ── Dark Mode update (enable / disable) ──────────────────────────────────
+    if (updateType === 'darkmode') {
+      const currentlyDisabled = currentConfig?.disableDarkMode ?? false;
+      const { enableDarkMode } = await prompts({
+        type: 'confirm',
+        name: 'enableDarkMode',
+        message: currentlyDisabled
+          ? 'Enable dark mode support in your project?'
+          : 'Disable dark mode support in your project? (This will hide the toggle and force light mode)',
+        initial: !currentlyDisabled,
+      });
+
+      if (enableDarkMode === undefined) return;
+
+      const newDisableDarkMode = !enableDarkMode;
+
+      const spinner = ora(
+        newDisableDarkMode ? 'Disabling dark mode...' : 'Enabling dark mode...'
+      ).start();
+      try {
+        // Persist the selection
+        await writeXerticaConfig(targetDir, { disableDarkMode: newDisableDarkMode });
+
+        // Regenerate App.tsx with the new dark mode flag
+        const persistedCodes = await readLanguagesConfig(targetDir);
+        const selectedCodes =
+          persistedCodes && persistedCodes.length > 0 ? persistedCodes : DEFAULT_SELECTION;
+
+        await fs.writeFile(
+          path.join(targetDir, 'src', 'app', 'App.tsx'),
+          generateAppTsx(selectedCodes, newDisableDarkMode)
+        );
+
+        spinner.succeed(
+          newDisableDarkMode
+            ? 'Dark mode disabled successfully! (Locked to Light Mode)'
+            : 'Dark mode enabled successfully!'
+        );
+      } catch (error) {
+        spinner.fail('Failed to update dark mode configuration');
+        console.error(error);
+      }
+      return;
+    }
+
     // ── Project files update ──────────────────────────────────────────────────
     const { versionType } = await prompts({
       type: 'select',
@@ -1038,15 +1128,14 @@ program
           await writeLanguagesConfig(targetDir, selectedCodes);
         }
 
+        const projectConfig = await readXerticaConfig(targetDir);
+
         // Regenerate App.tsx and i18n.ts honoring the persisted language set
         await fs.writeFile(
           path.join(targetDir, 'src', 'app', 'App.tsx'),
-          generateAppTsx(selectedCodes)
-        );
-        await fs.writeFile(
-          path.join(targetDir, 'src', 'i18n.ts'),
-          generateI18nFile(selectedCodes)
+          generateAppTsx(selectedCodes, projectConfig?.disableDarkMode ?? false)
         );
+        await fs.writeFile(path.join(targetDir, 'src', 'i18n.ts'), generateI18nFile(selectedCodes));
 
         // Refresh locale JSON files for the selected languages (keys grow over
         // library updates) — but prune any orphans from prior selections.
@@ -1055,13 +1144,13 @@ program
         });
 
         // Regenerate AuthGuard preserving the current page set and assistant flag
-        const projectConfig = await readXerticaConfig(targetDir);
         const pagesDir = path.join(targetDir, 'src', 'pages');
         const existingPages = (await fs.pathExists(pagesDir)) ? await fs.readdir(pagesDir) : [];
         const hasLoginP = existingPages.includes('LoginPage.tsx');
         const hasHomeP = existingPages.includes('HomePage.tsx');
         const hasTemplateP = existingPages.includes('TemplatePage.tsx');
-        const hasAssistantP = projectConfig?.hasAssistant ?? existingPages.includes('AssistantPage.tsx');
+        const hasAssistantP =
+          projectConfig?.hasAssistant ?? existingPages.includes('AssistantPage.tsx');
         const firstProtectedP = hasHomeP ? '/home' : hasTemplateP ? '/template' : '/login';
         await fs.writeFile(
           path.join(targetDir, 'src', 'app', 'components', 'AuthGuard.tsx'),

package/bin/language-config.ts

@@ -71,10 +71,7 @@ export async function readLanguagesConfig(targetDir: string): Promise<string[] |
 }
 
 /** Write the language selection to `src/locales/.languages.json`. */
-export async function writeLanguagesConfig(
-  targetDir: string,
-  codes: string[]
-): Promise<void> {
+export async function writeLanguagesConfig(targetDir: string, codes: string[]): Promise<void> {
   const configPath = path.join(targetDir, 'src', 'locales', LANGUAGES_CONFIG_FILENAME);
   await fs.ensureDir(path.dirname(configPath));
   const payload: LanguagesConfigFile = { version: 1, codes };
@@ -273,9 +270,10 @@ export default i18n;
  * we omit the prop entirely (the library default already matches). Otherwise
  * we emit an explicit array.
  */
-export function generateAppTsx(selectedCodes: string[]): string {
+export function generateAppTsx(selectedCodes: string[], disableDarkMode: boolean = false): string {
   const selectedLangs = SUPPORTED_LANGUAGES.filter(l => selectedCodes.includes(l.code));
   const isMonolingual = selectedLangs.length === 1;
+  const disableDarkModeProp = disableDarkMode ? `\n          disableDarkMode={true}` : '';
   const isAllDefaults =
     selectedLangs.length === SUPPORTED_LANGUAGES.length &&
     selectedLangs.every(l => DEFAULT_SELECTION.includes(l.code));
@@ -285,8 +283,7 @@ export function generateAppTsx(selectedCodes: string[]): string {
   // prop (the library default matches). Otherwise we emit the explicit set.
   const languagesArrayLiteral = selectedLangs
     .map(
-      l =>
-        `            { code: '${l.code}', label: '${l.label}', shortLabel: '${l.shortLabel}' },`
+      l => `            { code: '${l.code}', label: '${l.label}', shortLabel: '${l.shortLabel}' },`
     )
     .join('\n');
 
@@ -333,7 +330,7 @@ export default function App() {
       <QueryClientProvider client={queryClient}>
         <XerticaProvider
           apiKey={geminiApiKey}
-          googleMapsApiKey={googleMapsApiKey}${availableLanguagesProp}
+          googleMapsApiKey={googleMapsApiKey}${availableLanguagesProp}${disableDarkModeProp}
         >
           <Router>
             {/* AuthProvider must be inside Router (needs useNavigate) */}

package/components/assistant/modern-chat-input/ModernChatInput.tsx

@@ -219,9 +219,17 @@ export function ModernChatInput({
   const getActionInfo = (action: ActionType) => {
     switch (action) {
       case 'document':
-        return { label: t('assistant.actions.createDocument'), icon: FileText, color: 'bg-[var(--chart-4)]' };
+        return {
+          label: t('assistant.actions.createDocument'),
+          icon: FileText,
+          color: 'bg-[var(--chart-4)]',
+        };
       case 'podcast':
-        return { label: t('assistant.actions.generatePodcast'), icon: Radio, color: 'bg-[var(--chart-1)]' };
+        return {
+          label: t('assistant.actions.generatePodcast'),
+          icon: Radio,
+          color: 'bg-[var(--chart-1)]',
+        };
       case 'search':
         return { label: t('assistant.actions.search'), icon: Search, color: 'bg-[var(--chart-2)]' };
       default:
@@ -280,7 +288,9 @@ export function ModernChatInput({
                   ))}
                 </div>
 
-                <span className="text-sm font-medium text-destructive">{t('assistant.recordingAudio')}</span>
+                <span className="text-sm font-medium text-destructive">
+                  {t('assistant.recordingAudio')}
+                </span>
               </div>
 
               <div className="flex items-center gap-3">
@@ -478,7 +488,9 @@ export function ModernChatInput({
                         ? 'bg-destructive hover:bg-destructive/90 text-white animate-pulse'
                         : 'text-muted-foreground hover:bg-accent hover:text-foreground'
                     }`}
-                    aria-label={isRecording ? t('assistant.stopRecording') : t('assistant.suggestWithVoice')}
+                    aria-label={
+                      isRecording ? t('assistant.stopRecording') : t('assistant.suggestWithVoice')
+                    }
                   >
                     <Mic className="w-4 h-4" />
                   </Button>
@@ -545,9 +557,7 @@ export function ModernChatInput({
         animate={{ opacity: 1, y: 0 }}
         transition={{ delay: 0.1 }}
       >
-        <p className="text-xs text-muted-foreground">
-          {t('assistant.disclaimer')}
-        </p>
+        <p className="text-xs text-muted-foreground">{t('assistant.disclaimer')}</p>
       </motion.div>
     </div>
   );

package/components/assistant/xertica-assistant/parts/AssistantConversationList.tsx

@@ -50,9 +50,7 @@ export function AssistantConversationList({
             <div className="text-center py-8">
               <Heart className="w-12 h-12 mx-auto text-muted-foreground/50 mb-2" />
               <p className="text-muted-foreground">
-                {activeTab === 'favoritos'
-                  ? t('assistant.noFavorites')
-                  : t('assistant.noHistory')}
+                {activeTab === 'favoritos' ? t('assistant.noFavorites') : t('assistant.noHistory')}
               </p>
             </div>
           ) : (

package/components/assistant/xertica-assistant/parts/AssistantFeedbackDialog.tsx

@@ -56,8 +56,16 @@ export function AssistantFeedbackDialog({
         <div className="grid gap-4 py-4 px-6">
           <Textarea
             className="min-h-[100px]"
-            placeholder={state.category ? t('assistant.feedbackDialog.placeholderOptional') : t('assistant.feedbackDialog.placeholder')}
-            aria-label={state.category ? t('assistant.feedbackDialog.placeholderOptional') : t('assistant.feedbackDialog.placeholder')}
+            placeholder={
+              state.category
+                ? t('assistant.feedbackDialog.placeholderOptional')
+                : t('assistant.feedbackDialog.placeholder')
+            }
+            aria-label={
+              state.category
+                ? t('assistant.feedbackDialog.placeholderOptional')
+                : t('assistant.feedbackDialog.placeholder')
+            }
             value={state.reason}
             onChange={e => onReasonChange(e.target.value)}
             rows={4}
@@ -69,7 +77,9 @@ export function AssistantFeedbackDialog({
             {t('common.cancel')}
           </Button>
           <Button onClick={onSubmit} disabled={!state.category && !state.reason.trim()}>
-            {state.category ? t('assistant.feedbackDialog.confirmAndSend') : t('assistant.feedbackDialog.send')}
+            {state.category
+              ? t('assistant.feedbackDialog.confirmAndSend')
+              : t('assistant.feedbackDialog.send')}
           </Button>
         </DialogFooter>
       </DialogContent>