{
  "$schema": "https://simt.app/cosmos-design/specification.schema.json",
  "version": "2.0.0",
  "updated": "2026-10-02",
  "status": "Normative design target",
  "owner": "SIMT product design and platform maintainers",
  "base": "https://simt.app/cosmos-design",
  "scope": "Shared foundations plus four platform parts: web page, web app, mobile app and watch app.",
  "implementationStatus": "Specification ready for implementation. Product refactors and native device validation are separate release work; examples use illustrative data.",
  "inheritance": "Platform rules are additive to common; product safety, privacy and accessibility take precedence.",
  "normativeLanguage": {
    "must": "Required for conformance.",
    "should": "Expected unless an explicit evidence-backed exception is recorded.",
    "may": "Optional within the common constraints."
  },
  "metrics": {
    "targets": {
      "web": {
        "value": 44,
        "unit": "css-px"
      },
      "android": {
        "value": 48,
        "unit": "dp"
      },
      "wear": {
        "value": 48,
        "unit": "dp"
      }
    },
    "webVitals": {
      "lcpMs": 2500,
      "inpMs": 200,
      "cls": 0.1,
      "percentile": 75
    },
    "documentation": {
      "htmlBytesPerRoute": 81920,
      "cssGzipBytes": 20480,
      "jsGzipBytes": 6144,
      "initialFontsBytes": 122880
    },
    "native": {
      "frameDeadline60HzMs": 16.67,
      "frameDeadline90HzMs": 11.11,
      "frameDeadline120HzMs": 8.33,
      "allowedJankPercent": 5
    }
  },
  "resources": {
    "rules": "https://simt.app/cosmos-design/rules.json",
    "tokens": "https://simt.app/cosmos-design/tokens.json",
    "schema": "https://simt.app/cosmos-design/specification.schema.json",
    "manifest": "https://simt.app/cosmos-design/manifest.json",
    "markdown": "https://simt.app/cosmos-design/specification.md",
    "css": "https://simt.app/cosmos-design/tokens.css",
    "releaseTemplate": "https://simt.app/cosmos-design/release-template.json"
  },
  "ruleCount": 76,
  "pages": [
    {
      "slug": "common",
      "number": "00",
      "label": "Common foundations",
      "title": "One universe.\nA coherent language.",
      "description": "The shared Cosmos contract: palette, type, geometry, components, accessibility, motion, data and production acceptance.",
      "url": "https://simt.app/cosmos-design/common",
      "markdown": "https://simt.app/cosmos-design/common.md",
      "ruleCount": 26,
      "sections": [
        {
          "id": "identity",
          "title": "Identity & authority",
          "url": "https://simt.app/cosmos-design/common#identity",
          "ruleIds": [
            "C01",
            "C02",
            "C03"
          ]
        },
        {
          "id": "palette",
          "title": "Color with a job",
          "url": "https://simt.app/cosmos-design/common#palette",
          "ruleIds": [
            "C04",
            "C05",
            "C06"
          ]
        },
        {
          "id": "typography",
          "title": "Readable at every scale",
          "url": "https://simt.app/cosmos-design/common#typography",
          "ruleIds": [
            "C07",
            "C08"
          ]
        },
        {
          "id": "geometry",
          "title": "Field, spine, aperture",
          "url": "https://simt.app/cosmos-design/common#geometry",
          "ruleIds": [
            "C09",
            "C10",
            "C11",
            "C25",
            "C26"
          ]
        },
        {
          "id": "components",
          "title": "Component contracts",
          "url": "https://simt.app/cosmos-design/common#components",
          "ruleIds": [
            "C12",
            "C13",
            "C14",
            "C15",
            "C16"
          ]
        },
        {
          "id": "motion",
          "title": "Motion earns its place",
          "url": "https://simt.app/cosmos-design/common#motion",
          "ruleIds": [
            "C17",
            "C18"
          ]
        },
        {
          "id": "accessibility",
          "title": "Everyone keeps their bearings",
          "url": "https://simt.app/cosmos-design/common#accessibility",
          "ruleIds": [
            "C19",
            "C20",
            "C21"
          ]
        },
        {
          "id": "implementation",
          "title": "Structured delivery & release",
          "url": "https://simt.app/cosmos-design/common#implementation",
          "ruleIds": [
            "C22",
            "C23",
            "C24"
          ]
        }
      ]
    },
    {
      "slug": "web-page",
      "number": "01",
      "label": "Web page",
      "title": "A horizon\nworth exploring.",
      "description": "Cosmos public and marketing websites: editorial horizons, a useful atlas, product evidence, conversion, SEO and restrained motion.",
      "url": "https://simt.app/cosmos-design/web-page",
      "markdown": "https://simt.app/cosmos-design/web-page.md",
      "ruleCount": 11,
      "sections": [
        {
          "id": "composition",
          "title": "The editorial horizon",
          "url": "https://simt.app/cosmos-design/web-page#composition",
          "ruleIds": [
            "P01",
            "P02"
          ]
        },
        {
          "id": "layout",
          "title": "Responsive composition",
          "url": "https://simt.app/cosmos-design/web-page#layout",
          "ruleIds": [
            "P03",
            "P04"
          ]
        },
        {
          "id": "atlas",
          "title": "An atlas that tells the truth",
          "url": "https://simt.app/cosmos-design/web-page#atlas",
          "ruleIds": [
            "P05",
            "P06"
          ]
        },
        {
          "id": "conversion",
          "title": "Confident, calm conversion",
          "url": "https://simt.app/cosmos-design/web-page#conversion",
          "ruleIds": [
            "P07",
            "P08"
          ]
        },
        {
          "id": "delivery",
          "title": "Fast by construction",
          "url": "https://simt.app/cosmos-design/web-page#delivery",
          "ruleIds": [
            "P09",
            "P10"
          ]
        },
        {
          "id": "release",
          "title": "Web page acceptance",
          "url": "https://simt.app/cosmos-design/web-page#release",
          "ruleIds": [
            "P11"
          ]
        }
      ]
    },
    {
      "slug": "web-app",
      "number": "02",
      "label": "Web app",
      "title": "Every signal.\nIn context.",
      "description": "Cosmos for Simt Social: continuous map/list discovery, context-preserving detail, activity composition, profiles, inbox and operations.",
      "url": "https://simt.app/cosmos-design/web-app",
      "markdown": "https://simt.app/cosmos-design/web-app.md",
      "ruleCount": 13,
      "sections": [
        {
          "id": "shell",
          "title": "A persistent social field",
          "url": "https://simt.app/cosmos-design/web-app#shell",
          "ruleIds": [
            "A01",
            "A02"
          ]
        },
        {
          "id": "discovery",
          "title": "Discover by place, time or people",
          "url": "https://simt.app/cosmos-design/web-app#discovery",
          "ruleIds": [
            "A03",
            "A04",
            "A05"
          ]
        },
        {
          "id": "participation",
          "title": "Honest participation",
          "url": "https://simt.app/cosmos-design/web-app#participation",
          "ruleIds": [
            "A06",
            "A07"
          ]
        },
        {
          "id": "composer",
          "title": "Compose with continuity",
          "url": "https://simt.app/cosmos-design/web-app#composer",
          "ruleIds": [
            "A08",
            "A09"
          ]
        },
        {
          "id": "operations",
          "title": "A precise operational console",
          "url": "https://simt.app/cosmos-design/web-app#operations",
          "ruleIds": [
            "A10"
          ]
        },
        {
          "id": "performance",
          "title": "A responsive working set",
          "url": "https://simt.app/cosmos-design/web-app#performance",
          "ruleIds": [
            "A11",
            "A12"
          ]
        },
        {
          "id": "release",
          "title": "Web app acceptance",
          "url": "https://simt.app/cosmos-design/web-app#release",
          "ruleIds": [
            "A13"
          ]
        }
      ]
    },
    {
      "slug": "mobile-app",
      "number": "03",
      "label": "Mobile app",
      "title": "A precise instrument.\nWithin reach.",
      "description": "Cosmos for SIMT Android: compass, map, sky, tracking and tool layouts, adaptive postures, native input, sensors and measured performance.",
      "url": "https://simt.app/cosmos-design/mobile-app",
      "markdown": "https://simt.app/cosmos-design/mobile-app.md",
      "ruleCount": 14,
      "sections": [
        {
          "id": "anatomy",
          "title": "The instrument field",
          "url": "https://simt.app/cosmos-design/mobile-app#anatomy",
          "ruleIds": [
            "M01",
            "M02"
          ]
        },
        {
          "id": "instruments",
          "title": "Fixed frame, living reading",
          "url": "https://simt.app/cosmos-design/mobile-app#instruments",
          "ruleIds": [
            "M03",
            "M04",
            "M05"
          ]
        },
        {
          "id": "components",
          "title": "Native affordances, Cosmos clarity",
          "url": "https://simt.app/cosmos-design/mobile-app#components",
          "ruleIds": [
            "M06",
            "M07"
          ]
        },
        {
          "id": "adaptive",
          "title": "Adapt to the available field",
          "url": "https://simt.app/cosmos-design/mobile-app#adaptive",
          "ruleIds": [
            "M08",
            "M09"
          ]
        },
        {
          "id": "sensors",
          "title": "Accurate data, humane permissions",
          "url": "https://simt.app/cosmos-design/mobile-app#sensors",
          "ruleIds": [
            "M10",
            "M11"
          ]
        },
        {
          "id": "performance",
          "title": "Native performance contracts",
          "url": "https://simt.app/cosmos-design/mobile-app#performance",
          "ruleIds": [
            "M12",
            "M13"
          ]
        },
        {
          "id": "release",
          "title": "Mobile acceptance",
          "url": "https://simt.app/cosmos-design/mobile-app#release",
          "ruleIds": [
            "M14"
          ]
        }
      ]
    },
    {
      "slug": "watch-app",
      "number": "04",
      "label": "Watch app",
      "title": "One glance.\nOne useful answer.",
      "description": "A simplified Cosmos for SIMT Wear OS: round-screen instruments, accessible rotary input, concise tools and battery-aware ambient states.",
      "url": "https://simt.app/cosmos-design/watch-app",
      "markdown": "https://simt.app/cosmos-design/watch-app.md",
      "ruleCount": 12,
      "sections": [
        {
          "id": "glance",
          "title": "The single-glance contract",
          "url": "https://simt.app/cosmos-design/watch-app#glance",
          "ruleIds": [
            "W01",
            "W02"
          ]
        },
        {
          "id": "type-input",
          "title": "Readable and reachable",
          "url": "https://simt.app/cosmos-design/watch-app#type-input",
          "ruleIds": [
            "W03",
            "W04"
          ]
        },
        {
          "id": "screens",
          "title": "A small set of useful tools",
          "url": "https://simt.app/cosmos-design/watch-app#screens",
          "ruleIds": [
            "W05",
            "W06",
            "W07"
          ]
        },
        {
          "id": "ambient",
          "title": "Ambient is a different composition",
          "url": "https://simt.app/cosmos-design/watch-app#ambient",
          "ruleIds": [
            "W08",
            "W09"
          ]
        },
        {
          "id": "performance",
          "title": "Battery is part of UX",
          "url": "https://simt.app/cosmos-design/watch-app#performance",
          "ruleIds": [
            "W10",
            "W11"
          ]
        },
        {
          "id": "release",
          "title": "Watch acceptance",
          "url": "https://simt.app/cosmos-design/watch-app#release",
          "ruleIds": [
            "W12"
          ]
        }
      ]
    }
  ],
  "provenance": [
    {
      "repository": "simt-landing",
      "paths": [
        "cosmos-design/index.html",
        "styles/cosmos-design.less",
        "scripts/cosmos-design.js"
      ],
      "observed": "One large guide; page-owned animated star canvases and mixed native/web examples.",
      "direction": "Replace with a static, linked specification with measurable rules and one optional atmospheric owner."
    },
    {
      "repository": "simt-social-landing",
      "paths": [
        "src/templates/partials/hero.hbs",
        "src/templates/partials/atlas.hbs",
        "src/styles/tokens.less"
      ],
      "observed": "Narrative hero, activity atlas, role discovery, privacy and multilingual public content.",
      "direction": "Keep the human story and useful atlas; use editorial horizons and actual product evidence."
    },
    {
      "repository": "simt-social",
      "paths": [
        "app/styles/tokens-dark.css",
        "app/routes/discover.tsx",
        "mockups/README.md"
      ],
      "observed": "Canonical warm palette, persistent social shell, map/list discovery, activity composer and moderation console.",
      "direction": "Preserve route responsibilities; improve context continuity, scanning, recovery and density."
    },
    {
      "repository": "simt-app",
      "paths": [
        "doc/design/COSMOS_REDESIGN.md",
        "core/ui/src/main/java/app/simt/core/ui/theme/Color.kt",
        "core/ui/src/main/java/app/simt/core/ui/theme/Motion.kt"
      ],
      "observed": "Native instrument palette and typography; adaptive maps, dials and tools.",
      "direction": "Task-first instruments with stable reference frames, deliberate reach zones and system-owned back behavior."
    },
    {
      "repository": "simt-app/wear",
      "paths": [
        "src/main/java/app/simt/wear/screens/HomeScreen.kt",
        "src/main/java/app/simt/wear/screens/CompassScreen.kt",
        "src/main/java/app/simt/wear/theme/WearColors.kt"
      ],
      "observed": "Compass, sky, geofence, plumb bob, targets and settings; cyan has a legacy tool-specific value.",
      "direction": "One-glance tools with shared signal meaning, round geometry and a genuinely quiet ambient state."
    }
  ],
  "sources": [
    {
      "name": "WCAG 2.2",
      "url": "https://www.w3.org/TR/WCAG22/",
      "use": "Web accessibility baseline; Cosmos adopts a stronger 44 CSS px target than the 24 CSS px AA minimum."
    },
    {
      "name": "Core Web Vitals",
      "url": "https://web.dev/articles/vitals",
      "use": "Field LCP, INP and CLS thresholds at the 75th percentile."
    },
    {
      "name": "Wear accessibility",
      "url": "https://developer.android.com/design/ui/wear/guides/foundations/accessibility",
      "use": "Touch geometry, text and assistive input on round screens."
    },
    {
      "name": "Wear always-on",
      "url": "https://developer.android.com/training/wearables/always-on",
      "use": "Ambient lifecycle, burn-in protection and battery-aware behavior."
    },
    {
      "name": "Design Tokens format",
      "url": "https://www.designtokens.org/tr/2025.10/format/",
      "use": "Typed token interchange; exported sRGB components retain exact hex anchors in extensions."
    }
  ]
}