@donotdev/cli 0.0.8 → 0.0.9

package/dist/index.js

@@ -8803,8 +8803,10 @@ function executeFirebaseCommand(args, options) {
     errorOutput
   };
 }
-function buildFirebaseDeployArgs(deployType, projectId, debug, force) {
-  const args = ["deploy", "--only", deployType, "--non-interactive"];
+function buildFirebaseDeployArgs(deployTargets, projectId, debug, force) {
+  const targets = Array.isArray(deployTargets) ? deployTargets : [deployTargets];
+  const targetString = targets.join(",");
+  const args = ["deploy", "--only", targetString, "--non-interactive"];
   if (projectId) {
     args.push("--project", projectId);
   }
@@ -10212,6 +10214,47 @@ To fix this, run:
   }
 }
 
+// packages/tooling/src/apps/deploy-rules.ts
+init_utils();
+async function deployRules(appDir, serviceAccountPath, projectId, config, options) {
+  const targets = [];
+  if (options.firestore) {
+    targets.push("firestore:rules");
+  }
+  if (options.firestoreIndexes) {
+    targets.push("firestore:indexes");
+  }
+  if (options.storage) {
+    targets.push("storage");
+  }
+  if (targets.length === 0) {
+    return;
+  }
+  const targetNames = targets.join(", ");
+  const s = Y2();
+  s.start(`Deploying ${targetNames}...`);
+  const args = buildFirebaseDeployArgs(targets, projectId, config.debug);
+  const result = executeFirebaseCommand(args, {
+    cwd: appDir,
+    serviceAccountPath,
+    projectId,
+    debug: config.debug
+  });
+  if (result.error) {
+    s.stop("Rules deployment failed");
+    throw result.error;
+  }
+  if (!result.success) {
+    s.stop("Rules deployment failed");
+    handleDeploymentFailure(
+      result,
+      `firebase ${args.join(" ")}`,
+      serviceAccountPath
+    );
+  }
+  s.stop(`${targetNames} deployed successfully`);
+}
+
 // packages/tooling/src/apps/deploy-utils.ts
 init_utils();
 import { spawnSync as spawnSync7 } from "node:child_process";
@@ -10332,6 +10375,9 @@ function validateFirebaseJson2(appDir) {
       valid: false,
       hasHosting: false,
       hasFunctions: false,
+      hasFirestoreRules: false,
+      hasFirestoreIndexes: false,
+      hasStorageRules: false,
       errors: [`firebase.json not found at: ${firebaseJsonPath}`]
     };
   }
@@ -10344,11 +10390,17 @@ function validateFirebaseJson2(appDir) {
     }
     const hasHosting = !!config.hosting;
     const hasFunctions = !!config.functions && Array.isArray(config.functions);
+    const hasFirestoreRules = !!config.firestore?.rules && pathExists(joinPath(appDir, config.firestore.rules));
+    const hasFirestoreIndexes = !!config.firestore?.indexes && pathExists(joinPath(appDir, config.firestore.indexes));
+    const hasStorageRules = !!config.storage?.rules && pathExists(joinPath(appDir, config.storage.rules));
     return {
       valid: true,
       projectId: config.projectId,
       hasHosting,
       hasFunctions,
+      hasFirestoreRules,
+      hasFirestoreIndexes,
+      hasStorageRules,
       errors: []
     };
   } catch (error2) {
@@ -10356,6 +10408,9 @@ function validateFirebaseJson2(appDir) {
       valid: false,
       hasHosting: false,
       hasFunctions: false,
+      hasFirestoreRules: false,
+      hasFirestoreIndexes: false,
+      hasStorageRules: false,
       errors: [
         `Invalid JSON format: ${error2 instanceof DoNotDevError ? error2.message : error2 instanceof Error ? error2.message : String(error2)}`
       ]
@@ -10520,16 +10575,36 @@ async function main5(options = {}) {
           hint: "Deploy cloud functions"
         });
       }
+      const hasRules = firebaseConfig2.hasFirestoreRules || firebaseConfig2.hasFirestoreIndexes || firebaseConfig2.hasStorageRules;
+      if (hasRules) {
+        choices.push({
+          title: "Rules only",
+          value: "rules",
+          hint: "Deploy Firestore/Storage rules"
+        });
+      }
       if (firebaseConfig2.hasHosting && firebaseConfig2.hasFunctions) {
         choices.push({
-          title: "Both frontend and functions",
+          title: "Frontend + Functions",
           value: "both",
-          hint: "Deploy everything"
+          hint: "Deploy hosting and functions"
+        });
+      }
+      const deployableKindsCount = [
+        firebaseConfig2.hasHosting,
+        firebaseConfig2.hasFunctions,
+        hasRules
+      ].filter(Boolean).length;
+      if (deployableKindsCount > 1) {
+        choices.push({
+          title: "All",
+          value: "all",
+          hint: "Deploy everything (hosting, functions, rules)"
         });
       }
       if (choices.length === 0) {
         log.error(
-          "No deployment targets found. firebase.json must have hosting or functions configuration."
+          "No deployment targets found. firebase.json must have hosting, functions, or rules configuration."
         );
         process.exit(1);
       }
@@ -10574,13 +10649,28 @@ async function main5(options = {}) {
       showFirebaseJsonError(firebaseConfig.errors, appDir, deploymentType);
       process.exit(1);
     }
-    if (deploymentType === "frontend" || deploymentType === "both") {
-      if (!firebaseConfig.hasHosting) {
-        log.error(
-          "firebase.json does not contain hosting configuration, but frontend deployment was requested."
-        );
-        process.exit(1);
-      }
+    const shouldDeployFrontend = (deploymentType === "frontend" || deploymentType === "both" || deploymentType === "all") && firebaseConfig.hasHosting;
+    const shouldDeployFunctions = (deploymentType === "functions" || deploymentType === "both" || deploymentType === "all") && firebaseConfig.hasFunctions;
+    const shouldDeployRules = (deploymentType === "rules" || deploymentType === "all") && (firebaseConfig.hasFirestoreRules || firebaseConfig.hasFirestoreIndexes || firebaseConfig.hasStorageRules);
+    if (deploymentType === "frontend" && !firebaseConfig.hasHosting) {
+      log.error(
+        "firebase.json does not contain hosting configuration, but frontend deployment was requested."
+      );
+      process.exit(1);
+    }
+    if (deploymentType === "functions" && !firebaseConfig.hasFunctions) {
+      log.error(
+        "firebase.json does not contain functions configuration, but functions deployment was requested."
+      );
+      process.exit(1);
+    }
+    if (deploymentType === "rules" && !shouldDeployRules) {
+      log.error(
+        "firebase.json does not contain rules configuration, but rules deployment was requested."
+      );
+      process.exit(1);
+    }
+    if (shouldDeployFrontend) {
       const buildStatus = validateBuild(appDir);
       let shouldBuild = false;
       if (!buildStatus.exists || buildStatus.isEmpty) {
@@ -10623,14 +10713,6 @@ async function main5(options = {}) {
         }
       }
     }
-    if (deploymentType === "functions" || deploymentType === "both") {
-      if (!firebaseConfig.hasFunctions) {
-        log.error(
-          "firebase.json does not contain functions configuration, but functions deployment was requested."
-        );
-        process.exit(1);
-      }
-    }
     clearFirebaseCache(appDir);
     Me(
       `App: ${appName}
@@ -10639,10 +10721,10 @@ Deployment: ${deploymentType}
 Service Account: ${serviceAccountResult.info.clientEmail}`,
       "Deployment Configuration"
     );
-    if (deploymentType === "frontend" || deploymentType === "both") {
+    if (shouldDeployFrontend) {
       await deployFrontend(appDir, serviceAccountPath, config.project, config);
     }
-    if (deploymentType === "functions" || deploymentType === "both") {
+    if (shouldDeployFunctions) {
       await deployFunctions(
         appDir,
         serviceAccountPath,
@@ -10650,6 +10732,13 @@ Service Account: ${serviceAccountResult.info.clientEmail}`,
         config
       );
     }
+    if (shouldDeployRules) {
+      await deployRules(appDir, serviceAccountPath, config.project, config, {
+        firestore: firebaseConfig.hasFirestoreRules,
+        firestoreIndexes: firebaseConfig.hasFirestoreIndexes,
+        storage: firebaseConfig.hasStorageRules
+      });
+    }
     Se("Deployment completed successfully!");
   } catch (error2) {
     if (error2 instanceof DoNotDevError) {
@@ -11180,7 +11269,7 @@ function generatePackageJson(templateName, mode, options = {}) {
       "dependencies-matrix.json not found. This command requires the matrix file."
     );
   }
-  const { matrix, cliVersion } = matrixResult;
+  const { matrix } = matrixResult;
   const template = matrix.templateMapping?.[templateName];
   if (!template) {
     throw new Error(`Template "${templateName}" not found in matrix`);
@@ -11244,6 +11333,7 @@ function generatePackageJson(templateName, mode, options = {}) {
     }
   }
   if (templateName.includes("functions")) {
+    result.main = "lib/index.js";
     result.engines = { node: "20" };
     if (options.appName) {
       const platform = templateName.includes("vercel") ? "Vercel" : "Firebase";
@@ -11371,6 +11461,8 @@ async function createApp(appName, appConfig, workspaceRoot, templatesRoot) {
   s.start(`Creating app: ${appName}`);
   await ensureDir(appDir);
   const templateDir = appTemplate === "demo" ? "app-demo" : appTemplate === "nextjs" ? "app-next" : "app-vite";
+  const firebaseProjectId = (appConfig?.firebaseProjectId ?? "").trim() || appName.toLowerCase().replace(/\s+/g, "-");
+  const firebaseRegion = appConfig?.firebaseRegion ?? "europe-west1";
   const replacements = {
     projectName: appName,
     appName,
@@ -11379,11 +11471,14 @@ async function createApp(appName, appConfig, workspaceRoot, templatesRoot) {
     needsCRUD: Boolean(appConfig.needsCRUD),
     setupGithubActions: false,
     appNames: [appName],
-    firebaseProjectId: appName.toLowerCase(),
+    firebaseProjectId,
+    firebaseRegion,
     firebaseSecretName: appName.toUpperCase().replace(/-/g, "_"),
     monorepoRelativePath: "../../packages/tooling",
     appTemplate,
-    isNextjs: appTemplate === "nextjs"
+    isNextjs: appTemplate === "nextjs",
+    YOUR_FIREBASE_PROJECT_ID: firebaseProjectId,
+    YOUR_REGION: firebaseRegion
   };
   const templateSourceDir = joinPath(templatesRoot, templateDir);
   const templateFiles = await glob("**/*", {
@@ -11476,6 +11571,32 @@ async function createApp(appName, appConfig, workspaceRoot, templatesRoot) {
       await replacePlaceholders(firebaseJsonDest, replacements);
     }
   }
+  const firebasercSource = joinPath(
+    deploymentTemplateDir,
+    ".firebaserc.example"
+  );
+  if (pathExists(firebasercSource)) {
+    const firebasercDest = joinPath(appDir, ".firebaserc");
+    await copy(firebasercSource, firebasercDest);
+    if (await isTextFile(firebasercDest)) {
+      await replacePlaceholders(firebasercDest, replacements);
+    }
+  }
+  if (appConfig.needsBackend && appConfig.backendPlatform === "firebase") {
+    const rulesFiles = [
+      "firestore.rules.example",
+      "firestore.indexes.json.example",
+      "storage.rules.example"
+    ];
+    for (const example of rulesFiles) {
+      const src = joinPath(deploymentTemplateDir, example);
+      if (pathExists(src)) {
+        const destName = example.replace(".example", "");
+        const dest = joinPath(appDir, destName);
+        await copy(src, dest);
+      }
+    }
+  }
   if (appTemplate === "nextjs" || appConfig.needsBackend && appConfig.backendPlatform === "vercel") {
     const vercelJsonSource = joinPath(
       deploymentTemplateDir,
@@ -11501,12 +11622,15 @@ async function createApp(appName, appConfig, workspaceRoot, templatesRoot) {
   }
   if (isInteractive) {
     Se("\u{1F389} App created successfully!");
+    const firebaseStep = appConfig.needsBackend && appConfig.backendPlatform === "firebase" ? `2. Set Firebase project: cd apps/${appName} && firebase use --add (or edit .firebase rc)
+3. bun install
+4. bun run dev` : `2. bun install
+3. bun run dev`;
     Me(
       `Next steps:
 
 1. cd apps/${appName}
-2. bun install
-3. bun run dev
+${firebaseStep}
 
 Happy coding!`,
       "\u{1F4CB} Next Steps"
@@ -11538,7 +11662,9 @@ async function main7(options) {
         selectedEntities: [],
         userAuth: "social",
         billing: true,
-        features: []
+        features: [],
+        firebaseProjectId: options.firebaseProjectId,
+        firebaseRegion: options.firebaseRegion
       };
       await createApp(appName, appConfig);
     } else {
@@ -11878,6 +12004,8 @@ async function main8(options) {
         overwrite: true
       });
       const rootTemplateDir = joinPath(templatesRoot, "root-consumer");
+      const firebaseProjectId = projectName.toLowerCase().replace(/\s+/g, "-");
+      const firebaseRegion = "europe-west1";
       const rootReplacements = {
         projectName,
         appNames: isMergeMode ? allAppNames : appNames,
@@ -11886,12 +12014,22 @@ async function main8(options) {
         monorepoRelativePath: relativeMonorepoPath,
         appTemplate: "vite",
         isNextjs: false,
-        firebaseProjectId: projectName.toLowerCase(),
+        firebaseProjectId,
+        firebaseRegion,
         firebaseSecretName: projectName.toUpperCase().replace(/-/g, "_"),
+        YOUR_FIREBASE_PROJECT_ID: firebaseProjectId,
+        YOUR_REGION: firebaseRegion,
         needsAuth,
         needsOAuth,
         needsBilling
       };
+      const firebaseRootFiles = /* @__PURE__ */ new Set([
+        "firebase.json.example",
+        ".firebaserc.example",
+        "firestore.rules.example",
+        "firestore.indexes.json.example",
+        "storage.rules.example"
+      ]);
       const files = await glob("**/*", {
         cwd: rootTemplateDir,
         dot: true,
@@ -11899,6 +12037,7 @@ async function main8(options) {
       });
       for (const file of files) {
         if (file === "package.json.example") continue;
+        if (firebaseRootFiles.has(file)) continue;
         const sourcePath = joinPath(rootTemplateDir, file);
         let destFileName = file;
         if (destFileName.endsWith(".example")) {
@@ -11973,6 +12112,8 @@ async function main8(options) {
         }
       }
       if (installDemoApp) {
+        const demoFirebaseProjectId = projectName.toLowerCase().replace(/\s+/g, "-");
+        const demoFirebaseRegion = "europe-west1";
         await copyTemplateFiles(demoTemplateDir, demoAppDir, {
           projectName,
           appName: "demo",
@@ -11980,8 +12121,11 @@ async function main8(options) {
           needsCRUD: false,
           setupGithubActions: false,
           appNames,
-          firebaseProjectId: projectName.toLowerCase(),
+          firebaseProjectId: demoFirebaseProjectId,
+          firebaseRegion: demoFirebaseRegion,
           firebaseSecretName: projectName.toUpperCase().replace(/-/g, "_"),
+          YOUR_FIREBASE_PROJECT_ID: demoFirebaseProjectId,
+          YOUR_REGION: demoFirebaseRegion,
           monorepoRelativePath: executionMode === "development" ? calculateRelativePath(projectDirNormalized, monorepoRoot) : "",
           appTemplate: "demo"
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/cli",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Command-line interface for DoNotDev Framework",
   "type": "module",
   "private": false,
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "commander": "^14.0.2",
+    "commander": "^14.0.3",
     "fast-glob": "^3.3.3"
   },
   "repository": {
@@ -59,5 +59,6 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"
-  }
+  },
+  "peerDependencies": {}
 }

package/templates/app-next/src/config/app.ts.example

@@ -29,7 +29,7 @@ export const appConfig: AppConfig = {
     name: APP_NAME,
     shortName: APP_SHORT_NAME,
     description: APP_DESCRIPTION,
-    // url: 'https://yourapp.com', // Uncomment for production
+    // Note: URL comes from NEXT_PUBLIC_APP_URL in .env, not here
 
     // Footer legal links - remove any you don't need
     footer: {

package/templates/app-vite/index.html.example

@@ -16,8 +16,13 @@
   <!-- ✅ PWA: Manifest link (if exists) -->
   <link rel="manifest" href="/manifest.json" />
   
-  <!-- ✅ PERFORMANCE: Load fonts early to avoid preload warnings -->
-  <link rel="stylesheet" href="/fonts/fonts.css" />
+  <!-- ✅ PERFORMANCE: Preload critical fonts (non-blocking) -->
+  <link rel="preload" href="/fonts/Inter-latin.woff2" as="font" type="font/woff2" crossorigin="anonymous">
+  <link rel="preload" href="/fonts/Roboto-400-latin.woff2" as="font" type="font/woff2" crossorigin="anonymous">
+  
+  <!-- ✅ PERFORMANCE: Load extended font subsets async (non-blocking) -->
+  <link rel="stylesheet" href="/fonts/fonts.css" media="print" onload="this.media='all'">
+  <noscript><link rel="stylesheet" href="/fonts/fonts.css"></noscript>
   
   <!-- ✅ PERFORMANCE: Preconnect to external domains (OAuth providers) -->
   <!-- GitHub OAuth -->
@@ -36,6 +41,23 @@
 
   <!-- ✅ PERFORMANCE: Critical CSS inlined here by build -->
   <style>
+    /* Critical @font-face declarations - must be inline for preloaded fonts to work */
+    @font-face {
+      font-family: Inter;
+      font-style: normal;
+      font-weight: 400 700;
+      font-display: swap;
+      src: url('/fonts/Inter-latin.woff2') format('woff2');
+      unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+    }
+    @font-face {
+      font-family: Roboto;
+      font-style: normal;
+      font-weight: 400;
+      font-display: swap;
+      src: url('/fonts/Roboto-400-latin.woff2') format('woff2');
+      unicode-range: U+0000-00FF;
+    }
     /* Critical above-the-fold styles */
     html, body {
       margin: 0;

package/templates/app-vite/src/config/app.ts.example

@@ -29,7 +29,7 @@ export const appConfig: AppConfig = {
     name: APP_NAME,
     shortName: APP_SHORT_NAME,
     description: APP_DESCRIPTION,
-    // url: 'https://yourapp.com', // Uncomment for production
+    // Note: URL comes from VITE_APP_URL in .env, not here
 
     // Footer legal links - remove any you don't need
     footer: {

package/templates/app-vite/src/pages/FormPageExample.tsx.example

@@ -13,10 +13,10 @@
 import { useEffect, useState } from 'react';
 
 import { Section, Button, Alert } from '@donotdev/components';
-import { EntityFormRenderer, useCrud } from '@donotdev/crud';
+import { useCrud } from '@donotdev/crud';
 import { useTranslation } from '@donotdev/core';
 import type { PageMeta } from '@donotdev/core';
-import { PageContainer, Link, useNavigate } from '@donotdev/ui';
+import { PageContainer, Link, EntityFormRenderer } from '@donotdev/ui';
 
 // Import your entity from root-level entities folder
 // import { productEntity } from 'entities/Product';
@@ -51,7 +51,6 @@ export const meta: PageMeta = {
 export default function ProductPage() {
   const { t } = useTranslation(NAMESPACE);
   const id = useParam('id');
-  const navigate = useNavigate();
   const isNew = id === 'new';
 
   // useCrud provides CRUD operations with optimistic updates
@@ -84,8 +83,8 @@ export default function ProductPage() {
       update(id, data); // No await - fires in background
     }
 
-    // Instant navigation - feels incredibly fast
-    navigate('/products');
+    // Navigation happens automatically via cancelPath (defaults to /products)
+    // Or you can navigate manually if needed
   };
 
   // ==========================================================================
@@ -121,6 +120,8 @@ export default function ProductPage() {
             onSubmit={handleSubmit}
             defaultValues={{ status: 'draft' }} // Initial values for new items
             submitText={t('create')}
+            // Cancel automatically navigates to /products (or cancelPath if provided)
+            cancelPath="/products"
           />
         ) : (
           // EDIT MODE
@@ -130,6 +131,8 @@ export default function ProductPage() {
             onSubmit={handleSubmit}
             defaultValues={formData} // Loaded data
             submitText={t('update')}
+            // Cancel automatically navigates to /products (or cancelPath if provided)
+            cancelPath="/products"
           />
         )}
       </Section>

package/templates/app-vite/src/pages/ListPageExample.tsx.example

@@ -14,7 +14,7 @@
 
 import { Package } from 'lucide-react';
 
-import { EntityList } from '@donotdev/crud';
+import { EntityList } from '@donotdev/ui';
 import { useAuth } from '@donotdev/auth';
 import type { PageMeta } from '@donotdev/core';
 import { PageContainer } from '@donotdev/ui';
@@ -51,17 +51,14 @@ export default function ProductsListPage() {
   // - Applies visibility rules based on user role
   // - Includes search, sort, pagination
   // - Add/Edit/Delete buttons with proper permissions
+  // - Automatic routing: edit/view -> /products/:id, create -> /products/new
 
   return (
     <PageContainer>
       <EntityList
         entity={productEntity}
         userRole={user?.role}
-        // Optional overrides:
-        // onRowClick={(item) => navigate(`/products/${item.id}`)}
-        // createPath="/products/new"
-        // hideActions={false}
-        // pageSize={25}
+        // Optional: basePath="/admin/products" or onClick={(id) => openSheet(id)}
       />
     </PageContainer>
   );
@@ -73,7 +70,7 @@ export default function ProductsListPage() {
 //
 // For a card-based grid instead of table:
 //
-// import { EntityCardList } from '@donotdev/crud';
+// import { EntityCardList } from '@donotdev/ui';
 //
 // export default function ProductsGridPage() {
 //   return (

package/templates/root-consumer/.firebaserc.example

@@ -0,0 +1,5 @@
+{
+  "projects": {
+    "default": "{{firebaseProjectId}}"
+  }
+}

package/templates/root-consumer/entities/ExampleEntity.ts.example

@@ -63,6 +63,7 @@ export const productEntity = defineEntity({
   // 'checkbox'  → Multiple selections
   // 'date'      → Date picker
   // 'timestamp' → Date + time
+  // 'price'     → Structured price (amount, currency, VAT, discount %)
   // 'images'    → Image upload (multiple)
   // 'reference' → Link to another entity
   //
@@ -120,7 +121,7 @@ export const productEntity = defineEntity({
     price: {
       name: 'price',
       label: 'price',
-      type: 'number',
+      type: 'price',
       visibility: 'guest',
       editable: 'admin',
       validation: { required: true },

package/templates/root-consumer/entities/demo.ts.example

@@ -99,7 +99,7 @@ const demoEntity = defineEntity({
     price: {
       name: 'price',
       label: 'price',
-      type: 'number',
+      type: 'price',  // Value: { amount, currency?, vatIncluded?, discountPercent? }
       visibility: 'guest',
       editable: 'admin',
       validation: { required: true },

package/templates/root-consumer/firestore.indexes.json.example

@@ -0,0 +1,4 @@
+{
+  "indexes": [],
+  "fieldOverrides": []
+}

package/templates/root-consumer/firestore.rules.example

@@ -0,0 +1,11 @@
+rules_version = '2';
+service cloud.firestore {
+  match /databases/{database}/documents {
+    function isAuthenticated() {
+      return request.auth != null;
+    }
+    match /{document=**} {
+      allow read, write: if isAuthenticated();
+    }
+  }
+}

package/templates/root-consumer/guides/dndev/COMPONENTS_CRUD.md.example

@@ -19,14 +19,14 @@ await remove('doc-id');
 Paginated list with automatic loading. For data tables.
 
 ```tsx
-const { items, loading, hasMore, loadMore } = useCrudList(productEntity);
+const { items, loading, refresh } = useCrudList(productEntity);
 ```
 
 ### useCrudCardList  
 Card-based list with infinite scroll.
 
 ```tsx
-const { items, loading, hasMore, loadMore, refresh } = useCrudCardList(articleEntity);
+const { items, loading, refresh } = useCrudCardList(articleEntity);
 ```
 
 ---
@@ -106,6 +106,9 @@ Field components are auto-rendered by `FormFieldRenderer`. You don't import them
 ### Numbers
 - `number` - Numeric input
 - `range` - Slider input
+- `rating` - Star rating input (1–5, configurable max)
+
+**Rating + comment (e.g. reviews):** Use two fields on the same entity — `rating` (type `rating`) for stars and `comment` (type `textarea`) for the text. The form renders them as separate rows; no composite field type needed.
 
 ### Boolean
 - `checkbox` - Checkbox input
@@ -153,7 +156,7 @@ import { useController, registerFieldType } from '@donotdev/crud';
 import type { ControlledFieldProps } from '@donotdev/crud';
 
 // Custom controlled component MUST use framework's useController (not react-hook-form's)
-function RatingField({
+function ScoreField({
   fieldConfig,
   control,
   errors,
@@ -179,7 +182,7 @@ function RatingField({
           onChange?.(value);
         }}
         min={0}
-        max={5}
+        max={10}
       />
       {fieldState?.error && (
         <span className="error">{fieldState.error.message}</span>
@@ -189,8 +192,8 @@ function RatingField({
 }
 
 registerFieldType({
-  type: 'rating',
-  controlledComponent: RatingField,
+  type: 'score',
+  controlledComponent: ScoreField,
 });
 ```