@wix/auto-patterns 1.43.0 → 1.45.0

package/dist/types/types/types.d.ts

@@ -1,5 +1,6 @@
 import { EntityPageConfig } from './EntityPageConfig';
 import { CollectionPageConfig } from './CollectionPageConfig';
+import { SettingsPageConfig } from './SettingsPageConfig';
 import { useOptimisticActions } from '@wix/patterns';
 import { CursorQueryResult, OffsetQueryResult } from './fetchData';
 interface BaseCollectionConfigCommon {
@@ -69,6 +70,7 @@ export interface CollectionPageConfigType extends BasePageConfig {
      */
     collectionPage: CollectionPageConfig;
     entityPage?: never;
+    settingsPage?: never;
 }
 export interface EntityPageConfigType extends BasePageConfig {
     /**
@@ -80,8 +82,21 @@ export interface EntityPageConfigType extends BasePageConfig {
      */
     entityPage: EntityPageConfig;
     collectionPage?: never;
+    settingsPage?: never;
 }
-export type PageConfig = CollectionPageConfigType | EntityPageConfigType;
+export interface SettingsPageConfigType extends BasePageConfig {
+    /**
+     * Page type discriminator.
+     */
+    type: 'settingsPage';
+    /**
+     * Settings page configuration.
+     */
+    settingsPage: SettingsPageConfig;
+    collectionPage?: never;
+    entityPage?: never;
+}
+export type PageConfig = CollectionPageConfigType | EntityPageConfigType | SettingsPageConfigType;
 export type EntityProps = {
     [key: string]: any;
 };
@@ -93,6 +108,10 @@ export interface IColumnValue<T> {
     row: Record<string, any>;
 }
 export type QueryOperator = 'CONTAINS' | 'ENDS_WITH' | 'EQ' | 'EXISTS' | 'GT' | 'GTE' | 'HAS_ALL' | 'HAS_SOME' | 'LT' | 'LTE' | 'NE' | 'STARTS_WITH' | 'URLIZED';
+export interface BaseInputRef {
+    focus?: () => void;
+    invalid?: boolean;
+}
 interface BaseField {
     /**
      * Field unique identifier (dot-path supported, e.g. 'primaryInfo.email').

package/dist/types/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types/types.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/filterCreators.d.ts

@@ -1,45 +1,36 @@
-import { FilterOptions } from '../hooks/useFilters';
-import { SchemaConfig } from '../types';
-interface FilterOption {
-    value: string;
-    label: string;
-}
+import { DynamicOptionsFilterConfig, EnumFilterConfig, Field, SchemaConfig } from '../types';
+import { FilterOptions } from '../hooks/useFiltersState';
 interface BaseFilterParams {
     id: string;
     fieldId: string;
     commonFilterProps: Record<string, any>;
+    fieldDefinition: Field;
 }
-export declare const createDateTimeFilter: ({ id, fieldId, commonFilterProps, config, }: BaseFilterParams & {
+export declare const createDateTimeFilter: ({ id, fieldId, commonFilterProps, config, fieldDefinition, }: BaseFilterParams & {
     config?: {
         mode?: "ONLY_PREDEFINED" | "ONLY_CUSTOM" | "COMBINE";
         presets?: string[];
         includeTime?: boolean;
     };
 }) => FilterOptions;
-export declare const createBooleanFilter: ({ id, fieldId, commonFilterProps, config, }: BaseFilterParams & {
+export declare const createBooleanFilter: ({ id, fieldId, fieldDefinition, commonFilterProps, config, }: BaseFilterParams & {
     config?: {
         trueLabel?: string;
         falseLabel?: string;
     };
 }) => FilterOptions;
-export declare const createNumberFilter: ({ id, fieldId, commonFilterProps, config, }: BaseFilterParams & {
+export declare const createNumberFilter: ({ id, fieldId, fieldDefinition, commonFilterProps, config, }: BaseFilterParams & {
     config?: {
         min?: number;
         max?: number;
         allowedDecimals?: boolean;
     };
 }) => FilterOptions;
-export declare const createEnumFilter: ({ id, fieldId, commonFilterProps, config, }: BaseFilterParams & {
-    config: {
-        options?: FilterOption[];
-        selectionMode?: "single" | "multiple";
-        optionType?: "select" | "radio" | "checkbox" | "inlineCheckbox";
-    };
+export declare const createEnumFilter: ({ id, fieldId, fieldDefinition, commonFilterProps, config, }: BaseFilterParams & {
+    config: EnumFilterConfig;
 }) => FilterOptions;
-export declare const createReferenceFilter: ({ id, fieldId, commonFilterProps, config, additionalParams, }: BaseFilterParams & {
-    config?: {
-        selectionMode?: "single" | "multiple";
-    };
+export declare const createReferenceFilter: ({ id, fieldId, fieldDefinition, commonFilterProps, config, additionalParams, }: BaseFilterParams & {
+    config?: DynamicOptionsFilterConfig;
     additionalParams: {
         referencedSchema: SchemaConfig;
     };

package/dist/types/utils/filterCreators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filterCreators.d.ts","sourceRoot":"","sources":["../../../src/utils/filterCreators.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,oBAAoB,GAAI,6CAKlC,gBAAgB,GAAG;IACpB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,iBAAiB,GAAG,aAAa,GAAG,SAAS,CAAC;QACrD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH,KAAG,aAWF,CAAC;AAEH,eAAO,MAAM,mBAAmB,GAAI,6CAKjC,gBAAgB,GAAG;IACpB,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,KAAG,aAyBF,CAAC;AAEH,eAAO,MAAM,kBAAkB,GAAI,6CAKhC,gBAAgB,GAAG;IACpB,MAAM,CAAC,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH,KAAG,aAWF,CAAC;AAEH,eAAO,MAAM,gBAAgB,GAAI,6CAK9B,gBAAgB,GAAG;IACpB,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;QACzB,aAAa,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;QACtC,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,gBAAgB,CAAC;KACjE,CAAC;CACH,KAAG,aA4CH,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,+DAMnC,gBAAgB,GAAG;IACpB,MAAM,CAAC,EAAE;QACP,aAAa,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;KACvC,CAAC;IACF,gBAAgB,EAAE;QAChB,gBAAgB,EAAE,YAAY,CAAC;KAChC,CAAC;CACH,KAAG,aAcH,CAAC"}
+{"version":3,"file":"filterCreators.d.ts","sourceRoot":"","sources":["../../../src/utils/filterCreators.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,KAAK,EACL,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAOzD,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,eAAe,EAAE,KAAK,CAAC;CACxB;AAED,eAAO,MAAM,oBAAoB,GAAI,8DAMlC,gBAAgB,GAAG;IACpB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,iBAAiB,GAAG,aAAa,GAAG,SAAS,CAAC;QACrD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH,KAAG,aAWF,CAAC;AAEH,eAAO,MAAM,mBAAmB,GAAI,8DAMjC,gBAAgB,GAAG;IACpB,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,KAAG,aAyBF,CAAC;AAEH,eAAO,MAAM,kBAAkB,GAAI,8DAMhC,gBAAgB,GAAG;IACpB,MAAM,CAAC,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH,KAAG,aAWF,CAAC;AAEH,eAAO,MAAM,gBAAgB,GAAI,8DAM9B,gBAAgB,GAAG;IACpB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,KAAG,aAkBH,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,gFAOnC,gBAAgB,GAAG;IACpB,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,gBAAgB,EAAE;QAChB,gBAAgB,EAAE,YAAY,CAAC;KAChC,CAAC;CACH,KAAG,aAUH,CAAC"}

package/dist/types/utils/minimalRequiredPatternsRuntimeCheck.d.ts

@@ -0,0 +1,5 @@
+export declare function minimalRequiredPatternsRuntimeCheck({ required, requiredBy, }: {
+    required: string;
+    requiredBy?: string;
+}): void;
+//# sourceMappingURL=minimalRequiredPatternsRuntimeCheck.d.ts.map

package/dist/types/utils/minimalRequiredPatternsRuntimeCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimalRequiredPatternsRuntimeCheck.d.ts","sourceRoot":"","sources":["../../../src/utils/minimalRequiredPatternsRuntimeCheck.ts"],"names":[],"mappings":"AAGA,wBAAgB,mCAAmC,CAAC,EAClD,QAAQ,EACR,UAAU,GACX,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,QAMA"}

package/dist/types/utils/minimalRequiredRuntimeCheck.d.ts

@@ -0,0 +1,9 @@
+export declare function minimalRequiredRuntimeCheck({ packageJson, required, requiredBy, }: {
+    packageJson: {
+        name: string;
+        version: string;
+    };
+    required: string;
+    requiredBy?: string;
+}): void;
+//# sourceMappingURL=minimalRequiredRuntimeCheck.d.ts.map

package/dist/types/utils/minimalRequiredRuntimeCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimalRequiredRuntimeCheck.d.ts","sourceRoot":"","sources":["../../../src/utils/minimalRequiredRuntimeCheck.ts"],"names":[],"mappings":"AAEA,wBAAgB,2BAA2B,CAAC,EAC1C,WAAW,EACX,QAAQ,EACR,UAA0B,GAC3B,EAAE;IACD,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,QAWA"}

package/docs/GETTING_STARTED.md

@@ -1,33 +1,86 @@
 # Getting Started
 *Build your first dashboard page on Patterns using Cursor.*
 
-## Library Installations
-Run the following command to install the library and its peer dependencies:
+## Setup
+
+Follow these steps to set up Auto Patterns with Cursor AI assistance:
+
+### 1. Create `aicm.json` at Project Root
+
 ```bash
-yarn add @wix/auto-patterns @wix/patterns @wix/design-system react-router-dom
+echo '{ "presets": ["@wix/ai-rules/yoshi-flow-bm"] }' > aicm.json
 ```
 
-## MCP Installations
+### 2. Add Postinstall Script
 
-- [Install Business Schema MCP in Cursor](https://github.com/wix-private/mcp-servers/tree/master/packages/business-schema-mcp)
-  - [cursor://anysphere.cursor-deeplink/mcp/install?name=business-schema&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJAd2l4L2J1c2luZXNzLXNjaGVtYS1tY3AiXX0%3D](cursor://anysphere.cursor-deeplink/mcp/install?name=business-schema&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJAd2l4L2J1c2luZXNzLXNjaGVtYS1tY3AiXX0%3D)
-- [Install Auto Patterns MCP in Cursor](https://github.com/wix-private/mcp-servers/tree/master/packages/auto-patterns-mcp)
-  - [cursor://anysphere.cursor-deeplink/mcp/install?name=auto-patterns&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJAd2l4L2F1dG8tcGF0dGVybnMtbWNwIl19](cursor://anysphere.cursor-deeplink/mcp/install?name=auto-patterns&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJAd2l4L2F1dG8tcGF0dGVybnMtbWNwIl19)
+Add a `postinstall` script to your root `package.json`:
 
-> Deep links to Cursor for convenience. If they do not work, please copy and paste them into your browser or install the MCPs manually.
+```json
+{
+  "name": "your-project",
+  "scripts": {
+    "postinstall": "yarn dlx @wix/ai-rules"
+  }
+}
+```
+
+### 3. Update `.gitignore`
+
+Add the following to your `.gitignore`:
 
-## Working with Auto Patterns
-A typical usage of Auto Patterns is to render a `AutoPatternsApp` component with a configuration object. You don't need to do it manually, but generate it through Cursor's chat.
-You can write a prompt like this:
 ```
-I want a dashboard page for sessions, use wix.bookings.v1.sessions fqdn for that.
+.cursor/*/aicm
 ```
 
-Then Cursor will retrieve the schema for the `wix.bookings.v1.sessions` FQDN and create an Auto Patterns configuration with custom data source.
+### 4. Run Yarn Install
+
+```bash
+yarn install
+```
+
+This will automatically install rules, MCP tools, and commands in `.cursor/rules` and `.cursor/commands` for all packages.
+
+### What You Get
+
+After running `yarn install`, you will have:
 
-Then, you can run your app and see the results.
-According to the results, you can ask Cursor to improve the configuration.
-For example, you can ask Cursor to add specific filters, actions, or custom columns.
+- **MCP Tools** - Business Schema MCP and Auto Patterns MCP for Cursor
+- **Cursor Rules** - AI rules for auto-patterns development
+- **2 Commands** - `init-auto-patterns` and `extend-auto-patterns`
+
+## Working with Auto Patterns
+
+Auto Patterns provides two Cursor commands to help you build dashboard pages:
+
+### `init-auto-patterns`
+
+Creates a new auto-patterns app from scratch with FQDN-based custom data sources.
+
+This interactive workflow will:
+1. Check and install required dependencies
+2. Ask what collection you're managing (e.g., Contacts, Products)
+3. Discover the SDK package for your FQDN
+4. Extract schema and let you select fields
+5. Generate working code with full CRUD operations
+
+### `extend-auto-patterns`
+
+Adds features to an existing auto-patterns app.
+
+Available features:
+- Entity pages (edit/view modes)
+- Filters and search
+- Views and sorting
+- Custom actions and bulk actions
+- Column overrides and custom components
+- Delete actions
+- Table/Grid toggle
+- Slots
+- And much more
+
+Both commands guide you through an interactive configuration process, ensuring you get exactly what you need.
+
+While you can interact directly with the MCP tools using natural language, we strongly recommend using the provided commands for the best results.
 
 ## Handling Translations
 You should provide translated values everywhere you configure or render text content, just like you do in the rest of your app.
@@ -43,7 +96,7 @@ import { AppConfig, AutoPatternsApp } from '@wix/auto-patterns';
 import { useTranslation } from 'react-i18next';
 
 const MyPage = () => {
-  const { t } = useTranslation();
+  const { t, ready } = useTranslation();
 
   const config: AppConfig = {
     pages: [
@@ -95,6 +148,8 @@ const MyPage = () => {
     ],
   };
 
+  if (!ready) return null;
+
   return <AutoPatternsApp configuration={config} />;
 };
 

package/mcp-docs/app_config_structure.md

@@ -38,8 +38,7 @@
 
 ## Common Configuration Mistakes to Avoid
 
-- Adding more than two pages
-- Mixing page types in a single configuration
+- Mixing page types incorrectly in a single page configuration
 - Including undefined optional fields
 - Selecting too many initial columns
 - Not designating exactly one page as `appMainPage: true`
@@ -59,7 +58,7 @@
 export interface AppConfig {
   pages: {
     id: string; // Page unique identifier (must be unique across the app)
-    type: 'collectionPage' | 'entityPage'; // Defines page type
+    type: 'collectionPage' | 'entityPage' | 'settingsPage'; // Defines page type
     appMainPage?: boolean; // Designates this page as the main page (exactly one page must have this set to true)
     collectionPage?: {
       route: {
@@ -449,9 +448,73 @@ export interface AppConfig {
         id: string; // ID matching your custom data source identifier
       };
     };
+    settingsPage?: {
+      route: {
+        path: string; // Route path for the settings page (e.g., '/settings')
+      };
+      entityTypeSource: 'custom'; // Data source type - settings pages use custom data sources
+      custom: { // REQUIRED - matches the custom data source identifier
+        id: string; // ID matching your custom data source identifier (e.g., 'app-settings')
+      };
+      title?: {
+        text: string; // Page title text
+      };
+      subtitle?: {
+        text: string; // Subtitle text
+        learnMore?: {
+          url: string; // Learn more URL
+          label?: string; // Learn more link label
+        };
+      };
+      actions?: {
+        moreActions?: { // Custom actions for the settings page (export, import, reset, etc.)
+          id: string; // Action identifier matching a custom action resolver
+          type: 'custom'; // Action type
+          label: string; // Action label displayed in menu
+          biName: string; // MANDATORY: Business intelligence name for analytics tracking
+        }[];
+      };
+      layout?: {
+        main: CardLayout[]; // Main content cards
+        sidebar?: CardLayout[]; // Optional sidebar cards
+      };
+    };
   }[];
 }
 
+// Settings page and Entity page layout types
+type CardLayout = {
+  type: 'card';
+  card: {
+    title: { text: string }; // Card header title
+    subtitle?: { text: string }; // Optional card subtitle
+    children: LayoutContent[]; // Card content items (fields reference data source schema)
+  };
+};
+
+type LayoutContent =
+  | {
+      type: 'field';
+      field: {
+        span?: number; // Grid columns (1-12)
+        fieldId: string; // Field ID from the data source schema (custom data source or CMS)
+      };
+    }
+  | {
+      type: 'container';
+      container: {
+        span?: number; // Grid columns (1-12)
+        children: LayoutContent[]; // Nested layout items
+      };
+    }
+  | {
+      type: 'component';
+      component: {
+        span?: number; // Grid columns (1-12)
+        componentId: string; // ID mapping to a custom component override
+      };
+    };
+
 type ActionItem = {
   id: string; // Unique identifier for the action
   type: 'update' | 'delete' | 'custom'; // Action type

package/mcp-docs/auto-patterns-guide.md

@@ -116,8 +116,7 @@ It is configured using a TypeScript file conforming to the `AppConfig` interface
 
 ## Common Configuration Mistakes to Avoid
 
-- Adding more than two pages
-- Mixing page types in a single configuration
+- Mixing page types incorrectly in a single page configuration
 - Including undefined optional fields
 - Selecting too many initial columns
 - Not designating exactly one page as `appMainPage: true`
@@ -137,7 +136,7 @@ It is configured using a TypeScript file conforming to the `AppConfig` interface
 export interface AppConfig {
   pages: {
     id: string; // Page unique identifier (must be unique across the app)
-    type: 'collectionPage' | 'entityPage'; // Defines page type
+    type: 'collectionPage' | 'entityPage' | 'settingsPage'; // Defines page type
     appMainPage?: boolean; // Designates this page as the main page (exactly one page must have this set to true)
     collectionPage?: {
       route: {
@@ -527,9 +526,73 @@ export interface AppConfig {
         id: string; // ID matching your custom data source identifier
       };
     };
+    settingsPage?: {
+      route: {
+        path: string; // Route path for the settings page (e.g., '/settings')
+      };
+      entityTypeSource: 'custom'; // Data source type - settings pages use custom data sources
+      custom: { // REQUIRED - matches the custom data source identifier
+        id: string; // ID matching your custom data source identifier (e.g., 'app-settings')
+      };
+      title?: {
+        text: string; // Page title text
+      };
+      subtitle?: {
+        text: string; // Subtitle text
+        learnMore?: {
+          url: string; // Learn more URL
+          label?: string; // Learn more link label
+        };
+      };
+      actions?: {
+        moreActions?: { // Custom actions for the settings page (export, import, reset, etc.)
+          id: string; // Action identifier matching a custom action resolver
+          type: 'custom'; // Action type
+          label: string; // Action label displayed in menu
+          biName: string; // MANDATORY: Business intelligence name for analytics tracking
+        }[];
+      };
+      layout?: {
+        main: CardLayout[]; // Main content cards
+        sidebar?: CardLayout[]; // Optional sidebar cards
+      };
+    };
   }[];
 }
 
+// Settings page and Entity page layout types
+type CardLayout = {
+  type: 'card';
+  card: {
+    title: { text: string }; // Card header title
+    subtitle?: { text: string }; // Optional card subtitle
+    children: LayoutContent[]; // Card content items (fields reference data source schema)
+  };
+};
+
+type LayoutContent =
+  | {
+      type: 'field';
+      field: {
+        span?: number; // Grid columns (1-12)
+        fieldId: string; // Field ID from the data source schema (custom data source or CMS)
+      };
+    }
+  | {
+      type: 'container';
+      container: {
+        span?: number; // Grid columns (1-12)
+        children: LayoutContent[]; // Nested layout items
+      };
+    }
+  | {
+      type: 'component';
+      component: {
+        span?: number; // Grid columns (1-12)
+        componentId: string; // ID mapping to a custom component override
+      };
+    };
+
 type ActionItem = {
   id: string; // Unique identifier for the action
   type: 'update' | 'delete' | 'custom'; // Action type
@@ -714,13 +777,20 @@ Notice how the `label` is derived from the `value` by capitalizing the first let
 
 ## Critical Page Rules
 
-- **Pages array must contain exactly two pages** - one collectionPage and one entityPage
 - **Exactly one page must have `appMainPage: true`** to designate it as the main page
 - **All page IDs referenced in relationships must exist in the configuration** - validate all `parentPageId` and `entityPageId` references
 
-## Default Generation
+## Page Types
+
+AutoPatterns supports three page types:
 
-* **Always generate two pages**:
+1. **collectionPage** - Displays a collection of entities in table/grid view
+2. **entityPage** - Displays details for a single entity with edit/view modes
+3. **settingsPage** - Form-based page for managing application settings and preferences
+
+## Default Generation (Collection/Entity Pages)
+
+* **For collection-based apps, generate two pages**:
 
   * One **collectionPage** (routePath: `/`)
   * One **entityPage** (routePath: `/[segment]/:entityId`)
@@ -729,6 +799,16 @@ Notice how the `label` is derived from the `value` by capitalizing the first let
     * The route path **must** include a descriptive segment (e.g., `/product/:entityId`, `/pet/:entityId`)
     * **Never use just `/:entityId`** - this conflicts with the collection page route and breaks routing
 
+## Settings Page Generation
+
+* **For settings-based apps**, generate a **settingsPage** with:
+  * Route path (e.g., `/settings`)
+  * Custom data source with schema and CRUD actions (same pattern as collection pages)
+  * Layout with main and optional sidebar cards
+  * Optional more actions for additional operations (export, import, reset)
+
+See [Settings Page](./settings_page.md) for detailed configuration.
+
 ## Page Connection Configuration
 
 ### Main Page Designation

package/mcp-docs/index.md

@@ -62,6 +62,10 @@ This index maps user requests to the appropriate section IDs for fetching releva
 **Topics**: Entity page view mode actions, primaryActions, secondaryActions, collection-style actions
 **Keywords**: view mode actions, primaryActions, secondaryActions, read-only entity actions, entity page view operations, collection-style entity actions, navigation actions
 
+### ID: `settings_page`
+**Topics**: Settings page configuration, form-based settings interface, custom data source, card-based layout, application preferences
+**Keywords**: settings page, settingsPage, form settings, custom data source, settings layout, preferences, configuration page, more actions, settings fields, main sidebar layout, SchemaConfig, entityTypeSource custom
+
 ### ID: `resolved_action`
 **Topics**: ResolvedAction interface, common return type for custom actions, field documentation
 **Keywords**: ResolvedAction, action return type, custom action interface, action fields, label, icon, onClick, disabled, hidden, tooltip, skin

package/mcp-docs/pages_configuration.md

@@ -2,13 +2,20 @@
 
 ## Critical Page Rules
 
-- **Pages array must contain exactly two pages** - one collectionPage and one entityPage
 - **Exactly one page must have `appMainPage: true`** to designate it as the main page
 - **All page IDs referenced in relationships must exist in the configuration** - validate all `parentPageId` and `entityPageId` references
 
-## Default Generation
+## Page Types
 
-* **Always generate two pages**:
+AutoPatterns supports three page types:
+
+1. **collectionPage** - Displays a collection of entities in table/grid view
+2. **entityPage** - Displays details for a single entity with edit/view modes
+3. **settingsPage** - Form-based page for managing application settings and preferences
+
+## Default Generation (Collection/Entity Pages)
+
+* **For collection-based apps, generate two pages**:
 
   * One **collectionPage** (routePath: `/`)
   * One **entityPage** (routePath: `/[segment]/:entityId`)
@@ -17,6 +24,16 @@
     * The route path **must** include a descriptive segment (e.g., `/product/:entityId`, `/pet/:entityId`)
     * **Never use just `/:entityId`** - this conflicts with the collection page route and breaks routing
 
+## Settings Page Generation
+
+* **For settings-based apps**, generate a **settingsPage** with:
+  * Route path (e.g., `/settings`)
+  * Custom data source with schema and CRUD actions (same pattern as collection pages)
+  * Layout with main and optional sidebar cards
+  * Optional more actions for additional operations (export, import, reset)
+
+See [Settings Page](./settings_page.md) for detailed configuration.
+
 ## Page Connection Configuration
 
 ### Main Page Designation