{ "$defs": { "ImageConfig": { "description": "Image optimization configuration for the project.", "properties": { "formats": { "items": { "type": "string" }, "type": "array" }, "lazyLoad": { "type": "boolean" }, "optimize": { "type": "boolean" }, "picture": { "description": "Wrap a multi-format image in a with one per format (default true). With it off the carries a srcset in the preferred format alone, which browsers that cannot decode that format will still select from.", "type": "boolean" }, "quality": { "properties": { "avif": { "type": "number" }, "jpeg": { "type": "number" }, "png": { "type": "number" }, "webp": { "type": "number" } }, "type": "object" }, "remoteDomains": { "description": "Hostnames whose remote (https) images are optimized through /cdn-cgi/image transform URLs (cloudflare service only), e.g. [\"drive.usercontent.google.com\"]. Remote sources from other hosts are left untouched.", "items": { "type": "string" }, "type": "array" }, "service": { "description": "How images are optimized: \"build\" runs Sharp at build time; \"cloudflare\" emits /cdn-cgi/image transform URLs served by Cloudflare Image Transformations (requires the feature to be enabled on the serving zone).", "enum": [ "build", "cloudflare" ], "type": "string" }, "sizes": { "type": "string" }, "widths": { "items": { "type": "number" }, "type": "array" } }, "type": "object" }, "StyleObject": { "additionalProperties": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "$ref": "#/$defs/StyleObject" } ] }, "description": "CSS style definition. camelCase property names follow CSSOM convention. Keys starting with :, ., &, or [ are treated as nested CSS selectors. Keys matching $media breakpoint names (or other @-prefixed at-rules) group nested rules. Nesting is recursive: selector and at-rule groups may nest to arbitrary depth (e.g. breakpoint → selector → pseudo-class), mirroring the compiler's recursive emission.", "properties": {}, "type": "object" } }, "$id": "https://jxsuite.com/schema/project/v1", "$schema": "https://json-schema.org/draft/2020-12/schema", "description": "Schema for Jx project.json files. A project.json file is the root anchor file for a Jx project, declaring site metadata, default settings, global styles, extensions, and build configuration. Open by design: extension-contributed sections are opaque top-level keys; the generated per-project entry document (project.schema.json) closes the composition.", "properties": { "$defs": { "description": "Global type definitions available to all pages.", "type": "object" }, "$elements": { "description": "Global custom element dependencies available to all pages. Items are $ref objects or npm package specifier strings.", "items": { "oneOf": [ { "additionalProperties": false, "properties": { "$ref": { "type": "string" } }, "required": [ "$ref" ], "type": "object" }, { "type": "string" } ] }, "type": "array" }, "$head": { "description": "Global entries applied to all pages. Array of element definitions for meta tags, link tags, script tags, etc.", "examples": [ [ { "attributes": { "href": "/favicon.svg", "rel": "icon" }, "tagName": "link" }, { "attributes": { "content": "Jx", "name": "generator" }, "tagName": "meta" } ] ], "items": { "properties": { "attributes": { "additionalProperties": { "type": "string" }, "type": "object" }, "tagName": { "type": "string" } }, "type": "object" }, "type": "array" }, "$media": { "additionalProperties": { "type": "string" }, "description": "Named media breakpoints following CSS @custom-media convention. Available in all component style objects. Declaring a pure color-scheme query (e.g. \"--dark\": \"(prefers-color-scheme: dark)\") additionally opts the site into the forced-scheme contract: @--dark style blocks are dual-emitted so a data-color-scheme attribute on overrides the OS preference, color-scheme is declared on :root, and a pre-paint script restores the visitor's persisted choice (spec §9.5).", "examples": [ { "--dark": "(prefers-color-scheme: dark)", "--lg": "(min-width: 1024px)", "--md": "(min-width: 768px)", "--sm": "(min-width: 640px)" } ], "type": "object" }, "$schema": { "description": "Relative path to the generated per-project schema (conventionally ./project.schema.json, written by `jx schema`).", "type": "string" }, "build": { "description": "Build configuration.", "properties": { "adapter": { "description": "Platform adapter for deployment-specific output.", "enum": [ "static", "cloudflare-pages", "cloudflare-workers", "node", "bun" ], "type": "string" }, "deploy": { "additionalProperties": false, "description": "Deployment tracking: the hosting project this repo publishes to. Identifiers only (no secrets) — safe to commit; Studio uses it to tell whether the publish workflow already exists. `adapter` says how the build is packaged; `deploy` says where it ships.", "properties": { "accountId": { "description": "Hosting account id (e.g. the Cloudflare account id).", "type": "string" }, "productionUrl": { "description": "Production URL of the connected hosting project.", "type": "string" }, "projectName": { "description": "Hosting project name (e.g. the Cloudflare Pages project).", "pattern": "^[a-z0-9][a-z0-9-]*$", "type": "string" }, "provider": { "description": "Hosting provider the project is connected to.", "enum": [ "cloudflare-pages" ], "type": "string" } }, "required": [ "provider", "accountId", "projectName" ], "type": "object" }, "format": { "default": "directory", "description": "Reserved; currently unused. Accepted for forward compatibility with single-file output (desktop single-file mode) — the build emits per-route directories regardless.", "enum": [ "directory", "single" ], "type": "string" }, "outDir": { "default": "./dist", "description": "Output directory for compiled site.", "type": "string" }, "headers": { "additionalProperties": false, "description": "Emit dist/_headers — the response headers only the build can know. Honored by Cloudflare Pages/Workers assets and Netlify; on the node/bun adapters the file documents what a reverse proxy in front of them must send.", "properties": { "cache": { "default": "auto", "description": "\"auto\" marks the content-addressed image variants immutable (RFC 8246) and revalidates everything else (RFC 9111). \"off\" emits no Cache-Control at all.", "enum": [ "auto", "off" ], "type": "string" }, "enabled": { "default": true, "type": "boolean" }, "rules": { "additionalProperties": { "additionalProperties": { "type": "string" }, "type": "object" }, "description": "Verbatim rules, merged after the generated block.", "propertyNames": { "pattern": "^/" }, "type": "object" }, "security": { "additionalProperties": false, "properties": { "contentTypeOptions": { "default": true, "type": "boolean" }, "csp": { "default": false, "description": "CSP Level 3. Off by default: unlike the other security headers this one governs code the build cannot see — a third-party script that loads a second script, a widget that opens a frame — so turning it on is a change to verify in the browser console, not a safe default. `script-src` is derived from the inline scripts and external origins the build emitted; `style-src` keeps 'unsafe-inline', because per-page