cortexphp · tymondesigns · Jan 26, 2026 · Jan 26, 2026 · Jan 26, 2026 · Jan 26, 2026
diff --git a/docs/assets/favicon.svg b/docs/assets/favicon.svg
diff --git a/docs/docs.json b/docs/docs.json
@@ -1,20 +1,20 @@
 {
     "$schema": "https://mintlify.com/docs.json",
-    "theme": "aspen",
+    "theme": "palm",
     "name": "CortexPHP",
     "colors": {
         "primary": "#1C85FE",
         "light": "#1C85FE",
         "dark": "#1C85FE"
     },
-    "favicon": "/favicon.svg",
+    "favicon": "/assets/favicon.svg",
     "icons": {
         "library": "lucide"
     },
     "navigation": {
-        "dropdowns": [
+        "products": [
             {
-                "dropdown": "JSON Schema",
+                "product": "JSON Schema",
                 "icon": "braces",
                 "groups": [
                     {
@@ -68,18 +68,13 @@
         "light": "/assets/logo-light.svg",
         "dark": "/assets/logo-dark.svg"
     },
-    "navbar": {
-        "primary": {
-            "type": "github",
-            "href": "https://github.com/cortexphp/json-schema"
-        }
-    },
     "contextual": {
         "options": ["copy", "view", "chatgpt", "claude"]
     },
     "footer": {
         "socials": {
-            "github": "https://github.com/cortexphp"
+            "github": "https://github.com/cortexphp",
+            "x": "https://twitter.com/cortexphp"
         }
     }
 }
diff --git a/docs/json-schema/advanced/conditional-validation.mdx b/docs/json-schema/advanced/conditional-validation.mdx
@@ -618,13 +618,13 @@ $complexSchema = Schema::object('complex_validation')
   <Card title="User Account Types" icon="users">
     Different validation rules for personal vs business accounts, or basic vs premium users.
   </Card>
-  <Card title="Payment Methods" icon="credit-card">
+  <Card title="Payment Methods" icon="wallet">
     Validate different payment types with their specific required fields and formats.
   </Card>
-  <Card title="Dynamic Forms" icon="form">
+  <Card title="Dynamic Forms" icon="file-text">
     Forms where required fields change based on user selections or enabled features.
   </Card>
-  <Card title="API Versioning" icon="code-branch">
+  <Card title="API Versioning" icon="git-branch">
     Different validation rules for different API versions or client types.
   </Card>
 </CardGroup>
diff --git a/docs/json-schema/advanced/definitions-refs.mdx b/docs/json-schema/advanced/definitions-refs.mdx
@@ -443,10 +443,10 @@ $ecommerceApiSchema = Schema::object('ecommerce_api')
   <Card title="Maintainability" icon="wrench">
     Update shared schemas in one place and have changes propagate throughout your API.
   </Card>
-  <Card title="Consistency" icon="check-double">
+  <Card title="Consistency" icon="shield-check">
     Ensure consistent validation rules across different parts of your application.
   </Card>
-  <Card title="Modularity" icon="cubes">
+  <Card title="Modularity" icon="boxes">
     Break complex schemas into manageable, reusable components.
   </Card>
 </CardGroup>
@@ -526,13 +526,13 @@ $schema->addDefinition(
 ## Common Use Cases
 
 <CardGroup cols={2}>
-  <Card title="API Schema Design" icon="api">
+  <Card title="API Schema Design" icon="server">
     Create reusable components for API request/response schemas across multiple endpoints.
   </Card>
-  <Card title="Domain Models" icon="cube">
+  <Card title="Domain Models" icon="box">
     Define common business objects like User, Product, Order that are used throughout your application.
   </Card>
-  <Card title="Configuration Schemas" icon="gear">
+  <Card title="Configuration Schemas" icon="cog">
     Share configuration patterns across different parts of your application configuration.
   </Card>
   <Card title="Form Validation" icon="file-text">

diff --git a/docs/json-schema/advanced/dependent-schemas.mdx b/docs/json-schema/advanced/dependent-schemas.mdx
@@ -553,10 +553,10 @@ $schema->dependentSchemas([
   <Card title="Dynamic Forms" icon="file-text">
     Forms where available fields and validation rules change based on user selections.
   </Card>
-  <Card title="API Configuration" icon="gear">
+  <Card title="API Configuration" icon="cog">
     Configuration objects where certain settings require additional parameters.
   </Card>
-  <Card title="Payment Processing" icon="credit-card">
+  <Card title="Payment Processing" icon="wallet">
     Different validation rules for different payment methods and options.
   </Card>
   <Card title="User Profiles" icon="user">

diff --git a/docs/json-schema/advanced/pattern-properties.mdx b/docs/json-schema/advanced/pattern-properties.mdx
@@ -476,13 +476,13 @@ $schema->patternProperties([
 ## Common Use Cases
 
 <CardGroup cols={2}>
-  <Card title="Dynamic Configuration" icon="gear">
+  <Card title="Dynamic Configuration" icon="cog">
     Configure applications with dynamic settings that follow naming conventions.
   </Card>
   <Card title="Multi-language Content" icon="globe">
     Validate internationalization data with language-specific property patterns.
   </Card>
-  <Card title="API Versioning" icon="code-branch">
+  <Card title="API Versioning" icon="git-branch">
     Handle different API versions with version-specific property validation.
   </Card>
   <Card title="Custom Fields" icon="puzzle-piece">

diff --git a/docs/json-schema/advanced/string-formats.mdx b/docs/json-schema/advanced/string-formats.mdx
@@ -204,10 +204,10 @@ $userProfileSchema->isValid($validProfile); // true
   <Card title="API Parameters" icon="code">
     Validate API endpoints, UUIDs, timestamps, and other structured data in API requests.
   </Card>
-  <Card title="Configuration Files" icon="gear">
+  <Card title="Configuration Files" icon="cog">
     Validate URLs, hostnames, IP addresses, and other configuration values.
   </Card>
-  <Card title="Data Import" icon="file-import">
+  <Card title="Data Import" icon="file-input">
     Validate formatted data during import processes with appropriate type checking.
   </Card>
 </CardGroup>
diff --git a/docs/json-schema/advanced/unevaluated-properties.mdx b/docs/json-schema/advanced/unevaluated-properties.mdx
@@ -413,13 +413,13 @@ $schema = Schema::object('strict_user', SchemaVersion::Draft_2019_09)
   <Card title="Strict API Contracts" icon="shield-check">
     Ensure API requests/responses contain only expected properties, even with conditional fields.
   </Card>
-  <Card title="Configuration Validation" icon="gear">
+  <Card title="Configuration Validation" icon="cog">
     Validate configuration files with complex conditional requirements and strict property control.
   </Card>
   <Card title="Form Validation" icon="file-text">
     Handle dynamic forms where available fields depend on user selections or conditions.
   </Card>
-  <Card title="Data Migration" icon="exchange-alt">
+  <Card title="Data Migration" icon="move">
     Validate data during migration with strict control over allowed properties and transformations.
   </Card>
 </CardGroup>
diff --git a/docs/json-schema/code-generation/from-classes.mdx b/docs/json-schema/code-generation/from-classes.mdx
@@ -499,16 +499,16 @@ Validation rules like minLength, pattern, format are not extracted from docblock
 ## Common Use Cases
 
 <CardGroup cols={2}>
-  <Card title="API Documentation" icon="api">
+  <Card title="API Documentation" icon="server">
     Generate OpenAPI schemas from your data transfer objects and API models.
   </Card>
   <Card title="Form Validation" icon="file-text">
     Create client-side validation schemas from your backend models.
   </Card>
-  <Card title="Data Migration" icon="exchange-alt">
+  <Card title="Data Migration" icon="move">
     Validate data integrity during migrations using existing model definitions.
   </Card>
-  <Card title="Configuration Validation" icon="gear">
+  <Card title="Configuration Validation" icon="cog">
     Generate schemas for application configuration classes.
   </Card>
 </CardGroup>
diff --git a/docs/json-schema/code-generation/from-closures.mdx b/docs/json-schema/code-generation/from-closures.mdx
@@ -466,10 +466,10 @@ function handleUserStuff($data, $action, $options = []) {}
   <Card title="Form Processing" icon="file-text">
     Create client-side validation from server-side form processing functions.
   </Card>
-  <Card title="Data Pipeline" icon="stream">
+  <Card title="Data Pipeline" icon="workflow">
     Validate data transformations and processing steps in data pipelines.
   </Card>
-  <Card title="Configuration" icon="gear">
+  <Card title="Configuration" icon="cog">
     Generate validation for configuration and setup functions.
   </Card>
 </CardGroup>
diff --git a/docs/json-schema/code-generation/from-enums.mdx b/docs/json-schema/code-generation/from-enums.mdx
@@ -625,10 +625,10 @@ try {
   <Card title="API Validation" icon="server">
     Validate API request parameters and response codes using enumerated values.
   </Card>
-  <Card title="Configuration" icon="gear">
+  <Card title="Configuration" icon="cog">
     Ensure application configuration uses only valid environment and option values.
   </Card>
-  <Card title="State Management" icon="state-machine">
+  <Card title="State Management" icon="workflow">
     Validate state transitions and status changes in business workflows.
   </Card>
   <Card title="Form Validation" icon="file-text">

diff --git a/docs/json-schema/code-generation/from-json.mdx b/docs/json-schema/code-generation/from-json.mdx
@@ -240,13 +240,13 @@ $apiSchema->isValid($singleUserResponse); // true
 ## Common Use Cases
 
 <CardGroup cols={2}>
-  <Card title="API Documentation" icon="api">
+  <Card title="API Documentation" icon="server">
     Import OpenAPI schemas for request/response validation in API applications.
   </Card>
-  <Card title="Configuration Management" icon="gear">
+  <Card title="Configuration Management" icon="cog">
     Validate application configuration files using predefined JSON schemas.
   </Card>
-  <Card title="Data Migration" icon="exchange-alt">
+  <Card title="Data Migration" icon="move">
     Import legacy schemas and validate data during migration processes.
   </Card>
   <Card title="Third-party Integration" icon="plug">

diff --git a/docs/json-schema/installation.mdx b/docs/json-schema/installation.mdx
@@ -62,7 +62,3 @@ If you're contributing to the package or want to run tests:
     ```
   </Step>
 </Steps>
-
-## Next Steps
-
-Now that you have the package installed, you're ready to create your first JSON Schema:
diff --git a/docs/json-schema/introduction.mdx b/docs/json-schema/introduction.mdx
@@ -13,63 +13,56 @@ icon: 'book-open'
 <CardGroup cols={2}>
   <Card
     title="Fluent Builder API"
-    icon="hammer"
     href="/json-schema/quickstart"
-    horizontal
+    icon="wand"
   >
     Build JSON Schemas using an intuitive fluent interface that feels natural and reduces boilerplate code.
   </Card>
   <Card
     title="Multi-Version Support"
-    icon="code-branch"
     href="/json-schema/versions"
-    horizontal
+    icon="layers"
   >
     Support for JSON Schema Draft-07, Draft 2019-09, and Draft 2020-12 with automatic feature validation.
   </Card>
   <Card
     title="Data Validation"
-    icon="circle-check"
-    horizontal
+    icon="shield-check"
   >
     Validate data against schemas with detailed error messages and boolean validation methods.
   </Card>
   <Card
     title="Type Safety"
-    icon="shield-check"
     href="/json-schema/installation"
-    horizontal
+    icon="shield"
   >
     Built with PHP 8.3+ features and strict typing for reliable, maintainable code.
   </Card>
   <Card
     title="Conditional Schemas"
-    icon="sitemap"
     href="/json-schema/advanced/conditional-validation"
-    horizontal
+    icon="git-branch"
   >
     Support for if/then/else, allOf, anyOf, oneOf, and not conditions for complex validation logic.
   </Card>
   <Card
     title="Code Generation"
-    icon="arrows-rotate"
     href="/json-schema/code-generation/from-classes"
-    horizontal
+    icon="sparkles"
   >
     Generate schemas automatically from PHP Classes, Enums, and Closures using reflection.
   </Card>
   <Card
     title="Rich Validation"
-    icon="list-check"
     href="/json-schema/schema-types/string"
-    horizontal
+    icon="check-check"
   >
     Comprehensive validation rules including formats, patterns, ranges, and custom constraints.
   </Card>
   <Card
     title="Version-Aware Features"
-    icon="magnifying-glass"
-    horizontal
+    href="/json-schema/versions"
+    icon="eye"
   >
     Automatic validation of version-specific features with helpful error messages.
   </Card>

diff --git a/docs/json-schema/mcp-server.mdx b/docs/json-schema/mcp-server.mdx
@@ -277,3 +277,15 @@ The MCP server provides access to comprehensive documentation, code examples, an
 </Accordion>
 </AccordionGroup>
 
+## Additional Resources
+
+<CardGroup cols={2}>
+  <Card
+    title="MCP Protocol"
+    icon="link"
+    href="https://modelcontextprotocol.io"
+  >
+    Learn more about the Model Context Protocol
+  </Card>
+</CardGroup>
+
diff --git a/docs/json-schema/quickstart.mdx b/docs/json-schema/quickstart.mdx
@@ -288,6 +288,7 @@ Schema::setDefaultVersion(SchemaVersion::Draft_07); // For maximum compatibility
   <Info>
   When `type` is "business", the `company_name` field becomes required. Personal accounts don't need a company name.
   </Info>
+  <a href="/json-schema/advanced/conditional-validation">Learn more about conditional validation</a>
 </Accordion>
 
 <Accordion title="Union Types - Multiple allowed types">
@@ -329,29 +330,3 @@ Schema::setDefaultVersion(SchemaVersion::Draft_07); // For maximum compatibility
   </Warning>
 </Accordion>
 </AccordionGroup>
-
-## Next Steps
-
-<CardGroup cols={2}>
-  <Card
-    title="Schema Types"
-    icon="shapes"
-    href="/schema-types/string"
-  >
-    Learn about all available schema types and their validation options
-  </Card>
-  <Card
-    title="Advanced Features"
-    icon="star"
-    href="/advanced/conditional-validation"
-  >
-    Explore conditional validation, definitions, and complex patterns
-  </Card>
-  <Card
-    title="Code Generation"
-    icon="code"
-    href="/code-generation/from-classes"
-  >
-    Generate schemas automatically from PHP classes and functions
-  </Card>
-</CardGroup>
diff --git a/docs/json-schema/schema-types/array.mdx b/docs/json-schema/schema-types/array.mdx
@@ -531,7 +531,7 @@ try {
   <Card title="Coordinates & Tuples" icon="map-pin">
     Validate fixed-length arrays like coordinates, RGB values, or structured tuples.
   </Card>
-  <Card title="Nested Hierarchies" icon="sitemap">
+  <Card title="Nested Hierarchies" icon="folder-tree">
     Validate complex nested structures like menu trees or organizational hierarchies.
   </Card>
 </CardGroup>
diff --git a/docs/json-schema/schema-types/boolean.mdx b/docs/json-schema/schema-types/boolean.mdx
@@ -387,10 +387,10 @@ $booleanSchema->isValid(false);    // true
 ## Common Use Cases
 
 <CardGroup cols={2}>
-  <Card title="Feature Toggles" icon="toggle-on">
+  <Card title="Feature Toggles" icon="toggle-right">
     Control application features and functionality with boolean flags and feature switches.
   </Card>
-  <Card title="User Preferences" icon="user-gear">
+  <Card title="User Preferences" icon="user-cog">
     Store user settings, notifications preferences, and privacy choices.
   </Card>
   <Card title="Permissions & Access" icon="lock">