diff --git a/docs/assets/favicon.svg b/docs/assets/favicon.svg
new file mode 100644
index 0000000..3d52675
--- /dev/null
+++ b/docs/assets/favicon.svg
@@ -0,0 +1,13 @@
+
\ No newline at end of file
diff --git a/docs/docs.json b/docs/docs.json
index 1007b9e..15732b0 100644
--- 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
index 79bfbff..d4b114d 100644
--- 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')
Different validation rules for personal vs business accounts, or basic vs premium users.
-
+
Validate different payment types with their specific required fields and formats.
-
+
Forms where required fields change based on user selections or enabled features.
-
+
Different validation rules for different API versions or client types.
diff --git a/docs/json-schema/advanced/definitions-refs.mdx b/docs/json-schema/advanced/definitions-refs.mdx
index 50c9e49..3fe554b 100644
--- 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')
Update shared schemas in one place and have changes propagate throughout your API.
-
+
Ensure consistent validation rules across different parts of your application.
-
+
Break complex schemas into manageable, reusable components.
@@ -526,13 +526,13 @@ $schema->addDefinition(
## Common Use Cases
-
+
Create reusable components for API request/response schemas across multiple endpoints.
-
+
Define common business objects like User, Product, Order that are used throughout your application.
-
+
Share configuration patterns across different parts of your application configuration.
diff --git a/docs/json-schema/advanced/dependent-schemas.mdx b/docs/json-schema/advanced/dependent-schemas.mdx
index 70ae0c4..8a8e875 100644
--- a/docs/json-schema/advanced/dependent-schemas.mdx
+++ b/docs/json-schema/advanced/dependent-schemas.mdx
@@ -553,10 +553,10 @@ $schema->dependentSchemas([
Forms where available fields and validation rules change based on user selections.
-
+
Configuration objects where certain settings require additional parameters.
-
+
Different validation rules for different payment methods and options.
diff --git a/docs/json-schema/advanced/pattern-properties.mdx b/docs/json-schema/advanced/pattern-properties.mdx
index 25a8a86..3c21645 100644
--- 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
-
+
Configure applications with dynamic settings that follow naming conventions.
Validate internationalization data with language-specific property patterns.
-
+
Handle different API versions with version-specific property validation.
diff --git a/docs/json-schema/advanced/string-formats.mdx b/docs/json-schema/advanced/string-formats.mdx
index 3a23a71..1b1b161 100644
--- a/docs/json-schema/advanced/string-formats.mdx
+++ b/docs/json-schema/advanced/string-formats.mdx
@@ -204,10 +204,10 @@ $userProfileSchema->isValid($validProfile); // true
Validate API endpoints, UUIDs, timestamps, and other structured data in API requests.
-
+
Validate URLs, hostnames, IP addresses, and other configuration values.
-
+
Validate formatted data during import processes with appropriate type checking.
diff --git a/docs/json-schema/advanced/unevaluated-properties.mdx b/docs/json-schema/advanced/unevaluated-properties.mdx
index 6c5720f..d258f48 100644
--- 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)
Ensure API requests/responses contain only expected properties, even with conditional fields.
-
+
Validate configuration files with complex conditional requirements and strict property control.
Handle dynamic forms where available fields depend on user selections or conditions.
-
+
Validate data during migration with strict control over allowed properties and transformations.
diff --git a/docs/json-schema/code-generation/from-classes.mdx b/docs/json-schema/code-generation/from-classes.mdx
index 9110b86..828bb03 100644
--- 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
-
+
Generate OpenAPI schemas from your data transfer objects and API models.
Create client-side validation schemas from your backend models.
-
+
Validate data integrity during migrations using existing model definitions.
-
+
Generate schemas for application configuration classes.
diff --git a/docs/json-schema/code-generation/from-closures.mdx b/docs/json-schema/code-generation/from-closures.mdx
index f2f3803..3e0aeb4 100644
--- 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 = []) {}
Create client-side validation from server-side form processing functions.
-
+
Validate data transformations and processing steps in data pipelines.
-
+
Generate validation for configuration and setup functions.
diff --git a/docs/json-schema/code-generation/from-enums.mdx b/docs/json-schema/code-generation/from-enums.mdx
index b847f2f..73dac60 100644
--- a/docs/json-schema/code-generation/from-enums.mdx
+++ b/docs/json-schema/code-generation/from-enums.mdx
@@ -625,10 +625,10 @@ try {
Validate API request parameters and response codes using enumerated values.
-
+
Ensure application configuration uses only valid environment and option values.
-
+
Validate state transitions and status changes in business workflows.
diff --git a/docs/json-schema/code-generation/from-json.mdx b/docs/json-schema/code-generation/from-json.mdx
index 51996ad..1cbdd18 100644
--- 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
-
+
Import OpenAPI schemas for request/response validation in API applications.
-
+
Validate application configuration files using predefined JSON schemas.
-
+
Import legacy schemas and validate data during migration processes.
diff --git a/docs/json-schema/installation.mdx b/docs/json-schema/installation.mdx
index e6aeb3b..32ffb32 100644
--- 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:
```
-
-## 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
index fedcd91..a370416 100644
--- a/docs/json-schema/introduction.mdx
+++ b/docs/json-schema/introduction.mdx
@@ -13,63 +13,56 @@ icon: 'book-open'
Build JSON Schemas using an intuitive fluent interface that feels natural and reduces boilerplate code.
Support for JSON Schema Draft-07, Draft 2019-09, and Draft 2020-12 with automatic feature validation.
Validate data against schemas with detailed error messages and boolean validation methods.
Built with PHP 8.3+ features and strict typing for reliable, maintainable code.
Support for if/then/else, allOf, anyOf, oneOf, and not conditions for complex validation logic.
Generate schemas automatically from PHP Classes, Enums, and Closures using reflection.
Comprehensive validation rules including formats, patterns, ranges, and custom constraints.
Automatic validation of version-specific features with helpful error messages.
diff --git a/docs/json-schema/mcp-server.mdx b/docs/json-schema/mcp-server.mdx
index 5199956..4382e24 100644
--- 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
+## Additional Resources
+
+
+
+ Learn more about the Model Context Protocol
+
+
+
diff --git a/docs/json-schema/quickstart.mdx b/docs/json-schema/quickstart.mdx
index 4ed42b3..17dabec 100644
--- a/docs/json-schema/quickstart.mdx
+++ b/docs/json-schema/quickstart.mdx
@@ -288,6 +288,7 @@ Schema::setDefaultVersion(SchemaVersion::Draft_07); // For maximum compatibility
When `type` is "business", the `company_name` field becomes required. Personal accounts don't need a company name.
+ Learn more about conditional validation
@@ -329,29 +330,3 @@ Schema::setDefaultVersion(SchemaVersion::Draft_07); // For maximum compatibility
-
-## Next Steps
-
-
-
- Learn about all available schema types and their validation options
-
-
- Explore conditional validation, definitions, and complex patterns
-
-
- Generate schemas automatically from PHP classes and functions
-
-
diff --git a/docs/json-schema/schema-types/array.mdx b/docs/json-schema/schema-types/array.mdx
index 604478f..2e0a38a 100644
--- a/docs/json-schema/schema-types/array.mdx
+++ b/docs/json-schema/schema-types/array.mdx
@@ -531,7 +531,7 @@ try {
Validate fixed-length arrays like coordinates, RGB values, or structured tuples.
-
+
Validate complex nested structures like menu trees or organizational hierarchies.
diff --git a/docs/json-schema/schema-types/boolean.mdx b/docs/json-schema/schema-types/boolean.mdx
index e17b6d8..9105f52 100644
--- 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
-
+
Control application features and functionality with boolean flags and feature switches.
-
+
Store user settings, notifications preferences, and privacy choices.
diff --git a/docs/json-schema/schema-types/integer.mdx b/docs/json-schema/schema-types/integer.mdx
index 9e2cb16..15596af 100644
--- a/docs/json-schema/schema-types/integer.mdx
+++ b/docs/json-schema/schema-types/integer.mdx
@@ -356,13 +356,13 @@ try {
Validate counts, quantities, stock levels, and other discrete numeric values.
-
+
Validate database IDs, reference numbers, and other unique integer identifiers.
Validate user ratings, test scores, and other integer-based measurements.
-
+
Validate integer configuration parameters like ports, timeouts, and limits.
diff --git a/docs/json-schema/schema-types/null.mdx b/docs/json-schema/schema-types/null.mdx
index a8f83bb..80d00c8 100644
--- a/docs/json-schema/schema-types/null.mdx
+++ b/docs/json-schema/schema-types/null.mdx
@@ -341,7 +341,7 @@ $processedDataSchema = Schema::object('processed_data')
Handle optional relationships and foreign key references that may not exist.
-
+
Represent fields that are only relevant under certain conditions.
diff --git a/docs/json-schema/schema-types/number.mdx b/docs/json-schema/schema-types/number.mdx
index da7a345..6751703 100644
--- a/docs/json-schema/schema-types/number.mdx
+++ b/docs/json-schema/schema-types/number.mdx
@@ -324,7 +324,7 @@ $integerSchema->isValid(42.5); // false (not whole number)
Validate user ratings, test scores, and other numeric feedback with defined scales.
-
+
Validate numeric configuration parameters with appropriate ranges and precision.
diff --git a/docs/json-schema/schema-types/object.mdx b/docs/json-schema/schema-types/object.mdx
index 2f67720..fa5fd9d 100644
--- a/docs/json-schema/schema-types/object.mdx
+++ b/docs/json-schema/schema-types/object.mdx
@@ -525,10 +525,10 @@ $schema->isValid([
Specify function parameters for AI agents and assistants to enable reliable tool invocation.
-
+
Validate JSON API payloads with structured data and specific field requirements.
-
+
Validate application configuration with known properties and constraints.
diff --git a/docs/json-schema/schema-types/string.mdx b/docs/json-schema/schema-types/string.mdx
index 2b1a8aa..f37e84b 100644
--- a/docs/json-schema/schema-types/string.mdx
+++ b/docs/json-schema/schema-types/string.mdx
@@ -285,10 +285,10 @@ $uuidSchema = Schema::string('id', SchemaVersion::Draft_2019_09)
Validate API parameters, paths, and identifiers with strict patterns and format requirements.
-
+
Validate configuration strings with enumerated values and predefined options.
-
+
Validate imported text data against expected patterns and formats before processing.
diff --git a/docs/json-schema/schema-types/union.mdx b/docs/json-schema/schema-types/union.mdx
index 368da76..cfdfbcc 100644
--- a/docs/json-schema/schema-types/union.mdx
+++ b/docs/json-schema/schema-types/union.mdx
@@ -403,7 +403,7 @@ $shapeSchema = Schema::union([SchemaType::Object], 'shape')
Support both string and numeric identifiers in APIs and databases.
-
+
Handle configuration values that can be different types (string, number, boolean).
diff --git a/docs/json-schema/versions.mdx b/docs/json-schema/versions.mdx
index e100098..78c6b3c 100644
--- a/docs/json-schema/versions.mdx
+++ b/docs/json-schema/versions.mdx
@@ -9,7 +9,7 @@ icon: 'history'
This package supports multiple JSON Schema specification versions with automatic feature validation to ensure compatibility.
-
+
Legacy version for maximum compatibility across tools and libraries. Includes core validation features and basic conditionals.