{ "$description": "Cosmos 2.4.0 normative rules with acceptance criteria, grouped by platform section", "$schema": "https://simt.space/cosmos-design/rules.schema.json", "version": "2.4.0", "updated": "2026-10-03", "status": "Normative specification", "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." }, "ruleCount": 80, "sections": [ { "id": "identity", "title": "Identity & authority", "summary": "A useful spatial system, with room for imagination.", "platform": "common", "url": "https://simt.space/cosmos-design/common#identity", "rules": [ { "id": "C01", "title": "Task before spectacle", "level": "must", "requirement": "Put the primary object, current state and next action in the first useful viewport. A decorative motif may frame them but cannot displace them. Use literal operational copy even when the visual language is celestial.", "acceptance": "In grayscale, a first-time reader can identify the task, state and next step. Removing all ornament leaves a complete interface.", "url": "https://simt.space/cosmos-design/common#c01" }, { "id": "C02", "title": "Shared core, four adapters", "level": "must", "requirement": "Apply these common rules and the relevant platform part together. Product safety, privacy and accessibility requirements take precedence. Older prototypes and repository guides are migration evidence where they disagree with v2.", "acceptance": "Each implementation brief names version 2.4.0, platform, applicable rule IDs, owner and any explicit exception with reason, evidence and review date.", "url": "https://simt.space/cosmos-design/common#c02" }, { "id": "C03", "title": "Original composition", "level": "must", "requirement": "Build visual identity from the focus aperture, context spine and horizon ribbon. An aperture frames one meaningful object and is drawn as a quasar: a solid core in the object's channel, a corona halo and, where space allows, an accretion ring. A spine connects current context to the next step; a ribbon orders actual time or distance. Compose with continuous fields and aligned rows before adding cards.", "acceptance": "Every motif names the information it carries. One quasar aperture per screen marks the focal object. Cards contain individual records; no nested record cards or identical boxes around every page section.", "url": "https://simt.space/cosmos-design/common#c03" } ] }, { "id": "palette", "title": "Color with a job", "summary": "The original Deep Space colors are preserved exactly.", "platform": "common", "url": "https://simt.space/cosmos-design/common#palette", "table": { "caption": "Deep Space token registry", "columns": ["Token", "sRGB", "oklch (web)", "Role"], "rows": [ ["void", "#120A14", "oklch(16.10% 0.0242 319.45deg)", "Page and immersive field"], ["void-edge", "#1F1126", "oklch(20.77% 0.0447 313.68deg)", "Depth at the edge of the field"], ["hull", "#1D1220", "oklch(20.34% 0.0317 318.9deg)", "Standard opaque surface"], ["hull-raised", "#2A1830", "oklch(24.45% 0.0506 317.34deg)", "Raised or selected surface"], ["hull-highest", "#352040", "oklch(28.55% 0.0626 313.19deg)", "Highest temporary surface"], ["ember", "#FF8C42", "oklch(75.36% 0.1637 50.4deg)", "Primary agency: create, continue, commit"], ["ember-soft", "#FFB27C", "oklch(82.54% 0.1139 55.48deg)", "Supporting warm emphasis"], ["rose", "#FF7E8A", "oklch(74.38% 0.1570 15.89deg)", "Social participation and attention"], ["violet", "#C9A0FF", "oklch(77.84% 0.1380 303.2deg)", "Identity, roles and transformation"], ["gold", "#FFC766", "oklch(86.11% 0.1307 79.28deg)", "Focus, time, precision and value"], ["cyan", "#00E5FF", "oklch(84.42% 0.1457 209.29deg)", "Live, connected and located"], ["moss", "#83B692", "oklch(73.03% 0.0750 153.51deg)", "Outdoor and natural categories"], ["danger", "#FF6978", "oklch(71.17% 0.1827 17.02deg)", "Destructive action and failure"], ["success", "#71D5A4", "oklch(79.88% 0.1186 160.71deg)", "Confirmed completion"], ["petrol", "#102C2D", "oklch(27.21% 0.0338 198.5deg)", "Map ground"], ["water", "#123D42", "oklch(33.30% 0.0470 205.97deg)", "Map water"], ["ink", "#FFF8F2", "oklch(98.29% 0.0110 63.36deg)", "Primary text on Deep Space"], ["muted", "#BBAEBB", "oklch(76.57% 0.0233 325.8deg)", "Supporting text"], ["faint", "#9A8B9A", "oklch(65.48% 0.0280 325.89deg)", "Secondary metadata; check actual surface"], ["dim", "#90839A", "oklch(62.93% 0.0371 310.51deg)", "Inactive ornament; not essential text"], ["boundary", "#9A8B9A", "oklch(65.48% 0.0280 325.89deg)", "Essential control outlines on dark surfaces"] ] }, "rules": [ { "id": "C04", "title": "Stable semantic channels", "level": "must", "requirement": "Use Ember for primary agency, Rose for social attention, Violet for identity, Gold for focus/time/value, Cyan for live/location state and Moss for nature. Danger and Success are separate status channels. Limit competing large accents to one dominant and two supporting channels; categorized data may use the spectrum with labels.", "acceptance": "Tokens resolve to the anchors below. A hue never supplies the only meaning. Category Moss cannot imply a successful operation; Rose cannot imply an error.", "url": "https://simt.space/cosmos-design/common#c04" }, { "id": "C05", "title": "Contrast is composited", "level": "must", "requirement": "Require 4.5:1 normal text, 3:1 large text and 3:1 essential control boundaries, focus and graphical objects against adjacent colors. Use boundary for necessary input outlines; line is decorative only. Check every gradient stop, translucent surface and hover/disabled distinction.", "acceptance": "Measure the final composited pairs in each theme. The measurements are published once at contrast-pairs.json; fetch that document when introducing a colour, pairing a translucent or gradient surface or checking a theme, and do not expect a token payload to carry them. Document any inactive-control exception. Faint is supporting text only on a passing surface; Dim is never needed to complete a task.", "url": "https://simt.space/cosmos-design/common#c05" }, { "id": "C06", "title": "Daylight, red and ambient", "level": "must", "requirement": "Offer Daylight Nebula where supported. Dark remains the signature; a persisted explicit choice wins over the system preference, and with no choice the system preference is followed. Astronomy red is user-selected for instruments, uses only red luminance and retains text contrast. Watch ambient may use pure black for OLED efficiency. Theme adapters preserve the brand anchors and alter semantic role mappings, and an accent used as text takes the profile's accent-text role rather than its fill role.", "acceptance": "Theme switches retain layout, focus, selection and data. Red never flashes white/cyan on entry, dialogs or loading. Dark controls use dark on-action text; the existing Daylight Ember requires dark text, not assumed white. Test astronomy text on its action fill.", "url": "https://simt.space/cosmos-design/common#c06" }, { "id": "C29", "title": "One colour truth, two notations", "level": "must", "requirement": "Author and verify colour in sRGB and publish an oklch projection for the web parts. The anchors, gradients, shadows and semantic roles stay sRGB in the specification, because contrast is defined on sRGB luminance and every published contrast pair is measured there. Web tokens may be written in oklch from the projection in platformAdapters, so one role can step lightness without re-picking a hue. Android and Wear read sRGB: neither toolkit has an Oklab colour space, so a converted value would be a hex with extra steps.", "acceptance": "Every published web oklch resolves back to the sRGB value it came from within one 8-bit step, and every contrast claim is measured against the sRGB value. A colour is changed once, in hex, and both notations move together; no theme or component carries a colour absent from the registry.", "url": "https://simt.space/cosmos-design/common#c29" } ] }, { "id": "light", "title": "Light with a job", "summary": "Eight gradients and two shadows. Each one is a named instrument, never a texture.", "platform": "common", "url": "https://simt.space/cosmos-design/common#light", "table": { "caption": "Gradient registry", "columns": ["Token", "Geometry", "Stops", "Job", "Profiles"], "rows": [ [ "gradient.field", "Radial 120% × 90% at 50% 0%", "void-edge → void @72%", "Root depth behind every Deep Space screen. Opaque, so text is measured against void-edge and void.", "deepSpace" ], [ "gradient.nebula", "Radial 50% × 50% at 50% 50%", "violet 26% → rose 13% @36% → ember 6% @64% → ember 0%", "One atmospheric field per screen, behind the focal object or a section entry; never behind reading text.", "deepSpace" ], [ "gradient.corona", "Radial 50% × 50% at 50% 50%", "gold 90% → ember 45% @14% → rose 12% @42% → rose 0%", "The only glow: the halo of the single focal object, painted in a box four to six times its diameter.", "deepSpace" ], [ "gradient.accretion", "Conic from 0° at 50% 50%", "ember → gold @25% → rose @50% → violet @75% → ember", "A 1–2 px ring around the focal object. Never progress, status or a control outline.", "deepSpace" ], [ "gradient.horizon", "Linear 90°", "ember 0% → ember @20% → gold @50% → violet @80% → violet 0%", "Light lines of 1–2 px: the top light of a surface, the horizon ribbon, a section signature.", "deepSpace, daylight" ], [ "gradient.rim", "Linear 135°", "ember 55% → ink 10% @45% → violet 50%", "A 1 px border light for the focal or selected surface, beside its essential boundary rather than replacing it.", "deepSpace" ], ["gradient.action", "Linear 180°", "ember-soft → ember @55%", "Fill of the one primary action. The Void label passes on every stop.", "deepSpace"], [ "gradient.spectrum", "Linear 90°", "ember → rose @20% → violet @40% → gold @60% → cyan @80% → moss", "The brand signature line. Category legends use solid labelled swatches instead.", "deepSpace, daylight" ] ] }, "rules": [ { "id": "C27", "title": "Gradient & glow grammar", "level": "must", "requirement": "Use only the published gradient and shadow tokens, each for its stated job: field for root depth, nebula for one atmospheric field, corona and accretion for the single focal object, horizon for 1–2 px light lines, rim for the border light of the focal or selected surface, action for the one primary action and spectrum for the brand signature. A screen has at most one corona, one accretion ring and one nebula. Light carries depth and focus, never status, selection or the only boundary, and text never takes a gradient fill. In Full tier the hero figure runs one ambient motion: the focal object's accretion disc revolves once every 40–90 s about the core, and every other light is static — including the accretion ring itself, because a boundary that moves stops being a boundary. Sky drift (C11) is the one alternative a screen may take instead. Deep Space uses the whole grammar, Daylight keeps horizon and spectrum, and astronomy red and watch ambient use none. A gradient token a profile does not run resolves to no gradient, so the element falls back to its flat role color instead of borrowing another profile's light.", "acceptance": "Every gradient and shadow in code resolves to a token name and its published geometry. Text over a gradient passes against every stop as an opaque pair. Removing all light leaves hierarchy, selection and boundaries intact. The revolving disc moves only `rotate` or `transform`, never a length, and is the only animation on the screen. Forced colors and astronomy red replace light with solid system or semantic borders.", "url": "https://simt.space/cosmos-design/common#c27" } ] }, { "id": "atmosphere", "title": "Stars at the edge", "summary": "One deterministic sky per screen, generated the same way on every platform.", "platform": "common", "url": "https://simt.space/cosmos-design/common#atmosphere", "table": { "caption": "Atmosphere by surface", "columns": ["Surface", "Field & nebula", "Star layer", "Focal light", "Lines"], "rows": [ [ "Web page hero", "Field and one nebula behind the focal object", "Screen density; masked from the narrative column", "Corona and accretion on the emblem or selected record", "Horizon top light; spectrum signature" ], ["Web page reading", "Field only", "None", "None", "Horizon section signature"], [ "Web app shell", "Field; no nebula", "Dialog density on sign-in, onboarding and empty states; never over a map or list", "Corona on the selected marker", "Horizon top light on the context pane" ], [ "Mobile instrument", "Field and one Full-tier nebula", "Screen density, cached once per screen", "Corona and accretion on the target", "Horizon top light on sheets" ], ["Mobile sheet & dialog", "Inherits the screen field", "Dialog density", "None", "Horizon top light; rim on the focal sheet"], ["Mobile sky & orrery", "Field only", "None: every mark is data", "Corona on the selected body", "None"], ["Watch interactive", "Solid Void", "None", "One static corona on the bearing or target marker", "None"], ["Watch ambient", "Pure black", "None", "None", "None"], ["Daylight", "Flat background", "None", "None", "Horizon and spectrum"], ["Astronomy red", "Flat red background", "None", "None", "Solid red boundaries only"] ] }, "rules": [ { "id": "C11", "title": "One deterministic sky", "level": "must", "requirement": "A screen, hero, panel or dialog background may own one edge star layer from the published starfield algorithm: stars only in the outer 20% band, area / 7,500 stars clamped 24–160 for screens and area / 10,000 clamped 12–72 for dialogs, three magnitudes, at least 70% Ink, no accent above 10% and at most three diffraction-spiked stars. Seed it from a stable surface ID and a 160 px/dp size bucket. Drop stars within 16 px/dp of known text or controls after generation; never reseed to avoid them. Records, maps, media, data canvases, sky charts and watch screens own no stars.", "acceptance": "The same surface ID and bucket reproduce the published fixture on every platform. The layer is one cached bitmap, texture or compositor layer, never an element or view per star. Full tier may drift the whole layer once per 90–160 s by at most 1.5% of the shorter edge; Reduced, Static, Save-Data and hidden states freeze it, and low power draws 40% of the stars. Removing the layer changes no semantics or available task.", "url": "https://simt.space/cosmos-design/common#c11" } ] }, { "id": "typography", "title": "Readable at every scale", "summary": "A confident display voice, with a quieter reading voice.", "platform": "common", "url": "https://simt.space/cosmos-design/common#typography", "table": { "caption": "Type roles; size / line height", "columns": ["Role", "Web", "Mobile", "Watch"], "rows": [ ["Narrative display", "48–88 / 1.05, fluid rem", "40–48sp / 1.1, entry only", "Not used"], ["Primary instrument", "48–72 / 1.1", "48–64sp / 1.1", "32–40sp / 1.1"], ["Page title", "28–36 / 1.2", "28–32sp / 1.2", "18–20sp / 1.25"], ["Section title", "20–24 / 1.3", "20–24sp / 1.3", "16–18sp / 1.3"], ["Body", "16–18 / 1.6", "16sp / 1.5", "14–16sp / 1.4"], ["Supporting", "14 / 1.5", "14sp / 1.45", "12–14sp / 1.4"], ["Control label", "14–16 / 1.3", "14–16sp / 1.3", "14–16sp / 1.3"] ] }, "rules": [ { "id": "C07", "title": "Families & language", "level": "must", "requirement": "Use Space Grotesk for Latin titles and instrumentation, Source Sans 3 for web reading and form text, native system body type on Android, and El Messiri for Arabic roles. Bundle fonts, declare fallbacks and reserve fallback geometry. Use zero tracking by default; uppercase and spaced labels are Latin-only enhancements.", "acceptance": "No third-party font requests. Arabic has no mixed-script heading caused by an unsupported font. Font fallback and final font both retain unclipped text and controls.", "url": "https://simt.space/cosmos-design/common#c07" }, { "id": "C08", "title": "Roles & number semantics", "level": "must", "requirement": "Use the roles below and rem/sp for text. Body line-height is 1.5–1.65; Arabic uses at least 1.6 with tested diacritic room. Reading columns are 55–72 characters. Instrument digits use tabular numerals, visible units and stable width; precision follows actual sensor/data accuracy.", "acceptance": "Web reflows at 400% on a 1280 CSS px viewport and text zoom at 200%; Android fontScale 2.0; watch largest system text. No essential label is clipped or replaced by an ellipsis-only value.", "url": "https://simt.space/cosmos-design/common#c08" } ] }, { "id": "geometry", "title": "Field, spine, aperture", "summary": "Geometry should organize attention, not create visual noise.", "platform": "common", "url": "https://simt.space/cosmos-design/common#geometry", "table": { "caption": "Platform geometry mapping", "columns": ["Role", "Web page / web app", "Android", "Wear"], "rows": [ ["Control — compact control, chip, field", "8 px", "8 dp", "round"], ["Secondary — inline affordance", "—", "10 dp", "—"], ["Emphasis — inline emphasis", "—", "14 dp", "—"], ["Record — card or list row", "16 px", "20 dp", "round"], ["Overlay — sheet or dialog", "24 px", "28 dp", "capsule"], ["Circle — instrument or compact icon control", "—", "round", "round"] ] }, "rules": [ { "id": "C09", "title": "Rhythm & mapped shape", "level": "must", "requirement": "Use 4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 80, 96, 128 units. One unit is a CSS px or native dp, so the same numbers serve every platform and none of them publishes a spacing scale of its own. Take corner geometry from the platform mapping published in tokens.json rather than from a local scale: 8 px / 16 px / 24 px on web, 8 dp / 10 dp / 14 dp / 20 dp / 28 dp on Android, and the native round and capsule shapes on Wear, which publish no dp radius at all. A part that needs another role adds it to the mapping first. Circles denote instruments or compact icon controls, not paragraph containers.", "acceptance": "Spacing and shape map to named tokens, and a component's corner radius matches its role in the mapping for the part it ships in. No screen carries an ad-hoc px or dp corner value, and a native shape is expressed as the native shape rather than approximated with a number. The Wear layout fits its round screen instead of shrinking its targets. Small-screen compression first removes ornament and gutters; it does not shrink the readable type or hit target.", "url": "https://simt.space/cosmos-design/common#c09" }, { "id": "C10", "title": "Surface budget", "level": "must", "requirement": "Use opaque Hull for reading and work. A panel, sheet or dialog may carry a horizon top light inset from its corners; only the focal surface adds a rim border. Canopy translucency is optional for one header or contextual overlay, with at least 88% opacity over imagery and an opaque fallback. Allow at most one backdrop blur region per visible screen, capped at 12px on web; disable it when measured costly. Borders establish hierarchy before light.", "acceptance": "The screen remains legible with blur unsupported or disabled. No live blur behind scrolling long copy, dialog inside a blurred sheet, or full-screen animated haze. Top light never touches a rounded corner at full intensity.", "url": "https://simt.space/cosmos-design/common#c10" }, { "id": "C25", "title": "Icons, imagery & diagrams", "level": "must", "requirement": "Use one consistent icon family per platform: Lucide on web or the established native library. Standard marks are 20–24px/dp with a consistent stroke; the target remains 44px/48dp. Custom marks are reserved for concepts without a familiar equivalent. Images show the real object/place/person with a declared crop and reserved aspect ratio; diagrams have text equivalents.", "acceptance": "Decorative icons are hidden from assistive technology. Icon-only controls have localized names; unfamiliar commands retain visible labels. Mirror navigational arrows only. No duplicate icon font, raster text, misleading geographic imagery or unsupported scientific precision.", "url": "https://simt.space/cosmos-design/common#c25" }, { "id": "C26", "title": "Layering & scroll ownership", "level": "must", "requirement": "Keep field, persistent chrome, contextual popover, modal and urgent feedback in that semantic order using a shared layer registry. Give each pane one scroll owner; the whole page reflows before adding nested scrolling. Bounded overflowing lists expose native scrolling and a visible edge/next-item or explicit navigation affordance. A fade cannot cover essential labels or intercept input.", "acceptance": "Popover/dialog/focus are never clipped by a record or overflow ancestor. Touch, wheel, keyboard and rotary reach all content. Scroll position and focus survive return from detail; closing a layer restores the correct owner. Reduced mode uses static scroll cues.", "url": "https://simt.space/cosmos-design/common#c26" } ] }, { "id": "components", "title": "Component contracts", "summary": "The same behavior travels; shape and density adapt.", "platform": "common", "url": "https://simt.space/cosmos-design/common#components", "tables": [ { "caption": "Shared state matrix", "columns": ["State", "Visible treatment", "Behavior / announcement", "Opted out by"], "rows": [ ["Default · C12", "Opaque surface, legible label, essential boundary", "Real enabled semantics", "every component declares it"], ["Hover · C12", "Tonal lift; no movement of layout", "Optional; a pointer that cannot hover simply never shows it", "12 × notInteractive"], ["Pressed · C12", "Inset tone; no movement of layout", "Equivalent to hover for touch and keyboard", "7 × notInteractive"], ["Focus · C12, C19", "2px Gold ring + dark separation, 3px offset", "Visible, unclipped and not obscured by sticky UI", "10 × notFocusable"], ["Pending · C12", "Stable label and small progress mark", "Busy, duplicate guard; cancel if operation allows", "6 × notAsync"], ["Disabled · C12", "Muted label, disabled semantics, adjacent reason if useful", "No opacity reduction of all ancestor content", "10 × alwaysAvailable"], ["Error · C13, C16", "Danger icon, explicit text and retry", "Preserve safe inputs; error related to source", "10 × noFailureMode"], ["Confirmed · C12", "Success check and specific confirmation", "Retain durable result in the surface", "13 × confirmedElsewhere"], [ "Selected · C12, C14", "Check, leading marker or tonal boundary; rim light may accompany, never replace it", "Selected / pressed / current state as appropriate", "13 × notSelectable" ], ["Stale · C16", "Muted surface and an age label beside the value", "The value stays readable and carries its age; never a pulse", "10 × notFetched"], [ "Offline · C16", "Dimmed live surfaces and an offline notice with what is still available", "Cached content stays readable; recovery names the retry", "11 × notNetworkBound" ] ] }, { "caption": "Component index", "columns": ["Component", "Rules"], "rows": [ ["Primary action", "C12, C19, C26"], ["Secondary action", "C12, C19"], ["Destructive action", "C12, C15, C19"], ["Field with Clear", "C13, C19, C20"], ["Chips and selection", "C12, C14, C19"], ["Record row", "C14, C10, C19"], ["Sheet", "C15, C26, M07, C19"], ["Dialog", "C15, C19"], ["Banner", "C16, C21, C19"], ["Toast", "C16, C19"], ["Empty state", "C16, C01, C19"], ["Reading and stat", "C08, C21, C19"], ["Compass dial", "M03, M10, W06, C18, C19"], ["Target marker", "C18, M03, M05, W05, C27"], ["Context spine", "A02, C26, C10"], ["Horizon ribbon", "A04, C27, C26"], ["Watch action capsule", "W02, W05, W03, C19"] ] } ], "rules": [ { "id": "C12", "title": "Actions & selection", "level": "must", "requirement": "Give a task region one visually dominant Ember action, filled with the action gradient and resting on the action shadow. Destructive actions use Danger and consequence-first confirmation where irreversible. Buttons expose default, hover, pressed, focus, pending, disabled, error and confirmed states. Selection uses shape/check plus aria-pressed, aria-selected or native semantics, while Gold focus is independent.", "acceptance": "Click/Enter/Space trigger once. Pending preserves the accessible name and width, exposes busy state and prevents duplicates. Confirm only after success; error restores safe retry without losing input.", "url": "https://simt.space/cosmos-design/common#c12" }, { "id": "C13", "title": "Inputs & validation", "level": "must", "requirement": "Keep visible labels; connect hint, requirement, counter and error. Use real input/select/radio/checkbox/switch semantics. A nonempty editable single-line field exposes a 44px web/48dp native Clear button that returns focus to the field. Do not add it to password, read-only or disabled fields. Validate on submit or meaningful exit without announcing every keystroke.", "acceptance": "Keyboard autofill, paste, password managers, IME and RTL text work. Invalid fields expose invalid state and a text error; submit focuses the first error or linked error summary. Safe values survive retries.", "url": "https://simt.space/cosmos-design/common#c13" }, { "id": "C14", "title": "Records & navigation", "level": "must", "requirement": "Keep records in aligned rows unless media/object identity justifies a card. Do not wrap nested links/buttons in another interactive target. Back follows history; Close dismisses a layer. Selected navigation combines label, boundary and programmatic current state. Navigation persists where the task does.", "acceptance": "Tab order matches reading order. Route navigation moves focus to a named destination heading; dialogs return focus to a surviving trigger. Back/forward restore filter, position and context as applicable.", "url": "https://simt.space/cosmos-design/common#c14" }, { "id": "C15", "title": "Dialog, sheet & popover", "level": "must", "requirement": "Use one modal layer with a visible title, Close action, safe dismissal policy and actions in reading order. Web uses native dialog or an audited equivalent with focus containment, Escape and background inertness. Mobile uses platform back and inset-aware sheets. Popovers anchor to triggers and reflow before viewport clipping.", "acceptance": "Focus cannot enter the background of a modal. Unsaved edits get an explicit discard decision. Last action is reachable with the keyboard open and large text. Tooltips never contain the only critical instruction.", "url": "https://simt.space/cosmos-design/common#c15" }, { "id": "C16", "title": "Feedback at the source", "level": "must", "requirement": "Use inline errors for local failures, a banner for screen-wide degraded state, and status/toast for confirmed transient results. Every primary surface designs first load, refresh/stale, empty, denied, offline, recoverable error, terminal unavailable and success. Loading reserves real geometry; shimmer is optional and never indefinite.", "acceptance": "Screen readers hear concise changes once; high-rate sensor updates are not live-announced each frame. Error copy says what happened, what remains safe and which action recovers. A toast is never the sole record of a failure.", "url": "https://simt.space/cosmos-design/common#c16" } ] }, { "id": "motion", "title": "Motion earns its place", "summary": "Use movement to explain a change. Silence is a valid finish.", "platform": "common", "url": "https://simt.space/cosmos-design/common#motion", "tables": [ { "caption": "Platform easing mapping", "columns": ["Purpose", "Web page / web app", "Android", "Wear"], "rows": [ ["Standard — in-place transform and state", "cubic-bezier(0.2, 0, 0.2, 1)", "cubic-bezier(0.2, 0, 0.2, 1)", "cubic-bezier(0.2, 0, 0.2, 1)"], [ "Arrival — emphasis and entrance", "cubic-bezier(0.22, 1, 0.36, 1); cubic-bezier(0.16, 0.84, 0.44, 1)", "cubic-bezier(0.05, 0.7, 0.1, 1)", "cubic-bezier(0.05, 0.7, 0.1, 1)" ], ["Departure — exit", "cubic-bezier(0.4, 0, 0.7, 0.2)", "cubic-bezier(0.3, 0, 0.8, 0.15)", "cubic-bezier(0.3, 0, 0.8, 0.15)"], ["Transform only", "—", "cubic-bezier(0.2, 0, 0, 1)", "cubic-bezier(0.2, 0, 0, 1)"] ] }, { "caption": "Motion motifs", "columns": ["Motif", "Job", "Duration", "Easing", "Reduced"], "rows": [ [ "targetAcquired", "Tell the person that the thing they were tracking is now the thing they have.", "300ms local state", "standard, arrival", "Opacity only, over the feedback duration; the ring appears already at its final angle." ], [ "listReveal", "Show that a set arrived, in an order a person can follow down.", "150ms feedback", "arrival", "Opacity only, staggered, over the feedback duration." ], [ "horizonSweep", "Carry time or progress across a wide surface without a spinner.", "500ms context change", "standard", "The band is placed at its final position and its opacity resolves over the feedback duration; no travel." ], [ "spineAdvance", "Move context forward one step, so the person always knows which step they are on.", "300ms local state", "standard", "The connector is placed at its final length and the two steps cross-resolve in opacity over the feedback duration." ], [ "sheetRise", "Show which context a layer came from, and leave it dismissible.", "300ms local state", "arrival, departure", "The scrim resolves over the feedback duration and the surface is presented at its resting offset." ], [ "dataStale", "Say that a reading is no longer fresh, without asking for attention.", "150ms feedback", "standard", "The dim resolves over the feedback duration, opacity only, once." ], [ "routeChange", "Carry the reader from one context to the next without losing the frame.", "500ms context change", "arrival, departure", "Both resolve in opacity over the feedback duration, with no travel." ] ] } ], "rules": [ { "id": "C17", "title": "Three effective tiers", "level": "must", "requirement": "Full uses 150ms feedback, 300ms local state, 500ms context change and the curve published for the part (C30). Reduced removes spatial travel and ambient loops; optional opacity feedback lasts at most 150ms. Static applies final state immediately. Explicit Static wins; reduced-motion, data saving, low power, thermal pressure and visibility can only lower the tier.", "acceptance": "Preference changes apply during the session. Full/Reduced/Static produce identical outcomes. Hidden screens and background tabs stop animation and sensor presentation. Hardware concurrency alone never determines ability or tier.", "url": "https://simt.space/cosmos-design/common#c17" }, { "id": "C18", "title": "Progress & moving data", "level": "must", "requirement": "Animate transform/opacity for transitional UI, avoiding width/height/blur animation. Never auto-pan a map during a user gesture. Sensor smoothing cannot conceal stale/low-confidence data; separate visual interpolation from the stored/announced reading. Auto-updating content provides pause or stable inspection when applicable.", "acceptance": "No flashing beyond accessibility limits, parallax-dependent meaning, autoplay sound or attention-pulsing CTA. Reduced motion does not disable accurate data. Waiting is stated as text, not inferred from a spinner.", "url": "https://simt.space/cosmos-design/common#c18" }, { "id": "C30", "title": "Easing is published per part", "level": "must", "requirement": "Use the easing set published for the part: web uses the standard curve with emphasis, entrance and exit for arriving and departing UI; Android and Wear use the standard curve with enter, exit and transform. Every part runs the same three durations; a part that needs another curve or duration publishes it in the mapping instead of defining one locally.", "acceptance": "Every transition resolves to a published curve, arrival and departure use opposite curves from the same set, and the reduced and static tiers still reach the final state without a curve. No component hard-codes a cubic-bezier, and a curve change is a mapping change rather than a silent divergence.", "url": "https://simt.space/cosmos-design/common#c30" }, { "id": "C31", "title": "One motif per state change", "level": "must", "requirement": "Animate a state change by naming the published motif whose job is that change, and spend only the properties, duration and easing tokens that motif lists. A change with no motif does not animate. A new choreography is added as a motif with its own job rather than designed once inside a component. The motifs are published in motion.json, and the curve parity fixture in that document is how a native port proves it matches.", "acceptance": "Every animated state change names a motif, and every motif in motion.json is reachable from at least one surface. No motif animates a property outside its allowed list, and none loops or repeats to hold attention: stale data dims and gains a label. Reduced removes travel and keeps an opacity change within the feedback duration; Static settles immediately and reaches the same final state as Full. A port reproduces the sampled curve values to the published precision, or the mapping is wrong.", "url": "https://simt.space/cosmos-design/common#c31" } ] }, { "id": "accessibility", "title": "Everyone keeps their bearings", "summary": "Input, language and physical access are part of the design.", "platform": "common", "url": "https://simt.space/cosmos-design/common#accessibility", "rules": [ { "id": "C19", "title": "Access baseline", "level": "must", "requirement": "Target WCAG 2.2 AA on web and equivalent native behavior. Adopt 44×44 CSS px web targets and 48×48dp Android/Wear targets; design the round watch layout to fit rather than shrinking targets. Provide visible focus, names/roles/values, heading structure, error relationships, alternatives to dragging and a skip link.", "acceptance": "Complete primary flows with keyboard, touch and a screen reader. Focus is not covered by sticky chrome. Forced colors preserves borders, icons and focus; controls use system colors where needed.", "url": "https://simt.space/cosmos-design/common#c19" }, { "id": "C20", "title": "Direction & localization", "level": "must", "requirement": "Use logical spacing and placement. Mirror navigation flow, never geography, north, compass mathematics or media playback. Isolate authored text, handles, coordinates and times. Localize visible copy, relative dates, plural counts, measurement units and accessible names. Persist unit preference independently of language.", "acceptance": "Test English, French, Arabic RTL and Spanish with long content and 200% expansion fixtures. Geographic points and bearing values are identical across directions. Critical facts remain readable in the full detail view.", "url": "https://simt.space/cosmos-design/common#c20" }, { "id": "C21", "title": "Privacy & honest content", "level": "must", "requirement": "Represent accuracy, confidence, time zone, stale data, approximate location and permission state explicitly. Do not imply live data from decoration. Keep private coordinates, profile fields, draft text and sensitive actions out of URLs, crawled pages, analytics and error messages. Use illustrative labels for invented specimen data.", "acceptance": "Privacy decisions are explained at the action. Public previews reveal only authorized data. A denied or blocked profile does not disclose which private condition caused its unavailability.", "url": "https://simt.space/cosmos-design/common#c21" } ] }, { "id": "implementation", "title": "Structured delivery & release", "summary": "Make the rules usable by people and machines.", "platform": "common", "url": "https://simt.space/cosmos-design/common#implementation", "table": { "caption": "Implementation content model", "columns": ["Field", "Required structure", "Purpose"], "rows": [ ["Rule", "id, title, level, requirement, acceptance", "Stable conformance mapping"], ["Platform", "slug, description, sections, inheritance", "A bounded adapter with common dependencies"], ["Token", "$type, $value, $description; semantic adapter", "Typed values; explicit units and color space"], ["Screen brief", "task, privacy class, layout, states, input, data, rules", "Enough context to implement without guessing"], ["Evidence", "version, build, route, environment, result, owner", "Traceable release decision"] ] }, "rules": [ { "id": "C22", "title": "One source & stable addresses", "level": "must", "requirement": "Maintain this specification in cosmos/. Generate HTML, plain Markdown, the typed token file and the complete specification JSON together. Stable rule IDs and section URLs are public contracts, and each part publishes its own tokens and rules payload carrying the common foundations plus only its own adapter. Return real files with correct MIME types; machine requests must not silently receive the home page.", "acceptance": "Generated-output drift fails verification. All routes, anchors, cross-links and downloads resolve in development, preview and production. Manifest includes version, status, scope, assets, platform inheritance and source provenance. A part payload is byte-identical to the canonical documents for everything it shares, carries exactly one adapter, and stays inside its published byte budget, so it cannot drift back into the union. A document needed only sometimes keeps its own address: composited contrast measurements are fetched from contrast-pairs.json instead of being embedded in a payload, and every published document states when to fetch it.", "url": "https://simt.space/cosmos-design/common#c22" }, { "id": "C23", "title": "Performance is measured", "level": "must", "requirement": "Use the platform budgets and release matrices. Web field targets are p75 LCP ≤2.5s, INP ≤200ms and CLS ≤0.1 for mobile and desktop cohorts. Lab tests are diagnostic, not a substitute for field results. Record route, build, device, browser/OS, network, locale, motion tier and method with evidence.", "acceptance": "A release has a named owner and real measurements. Visual specifications and mockups are never labeled proof that unimplemented products meet their runtime targets.", "url": "https://simt.space/cosmos-design/common#c23" }, { "id": "C24", "title": "Conformance & maintenance", "level": "must", "requirement": "Release only after applicable rules pass contrast, input, localization, state and performance checks. Record exceptions with affected rule, product reason, accessible alternative, owner and expiry. A palette or semantic-rule change requires a version update and migration note; minor additions preserve stable IDs.", "acceptance": "The release record links screenshots, accessibility findings, performance traces and resolved defects. Core maintainers review shared changes; platform maintainers review adapter changes. Broken required flows block acceptance.", "url": "https://simt.space/cosmos-design/common#c24" } ] }, { "id": "composition", "title": "The editorial horizon", "summary": "The first screen feels spacious and explains the product immediately.", "platform": "web-page", "url": "https://simt.space/cosmos-design/web-page#composition", "table": { "caption": "Public page sequence", "columns": ["Sequence", "Composition", "Decision answered"], "rows": [ ["01 Invitation", "Narrative + atlas + primary CTA", "What can I do here?"], ["02 Proof", "One real experience with annotated outcome", "Does the product deliver it?"], ["03 Path", "Discover → inspect → participate as a connected spine", "How does it work?"], ["04 Possibilities", "Role/category rows with real examples", "Is this relevant to me?"], ["05 Trust", "Plain privacy and location explanation", "What am I sharing?"], ["06 Questions", "Native disclosure FAQ", "What still stops me?"], ["07 Next step", "A calm final CTA and legal/locale links", "Where do I go next?"] ] }, "rules": [ { "id": "P01", "title": "Two complementary planes", "level": "must", "requirement": "Use a left-aligned narrative column and an asymmetric atlas on wide screens. The horizon is a fine shared baseline linking headline, time and place. On compact screens, show the proposition, one CTA and a cropped but meaningful atlas in normal reading order. The hero uses content height, not forced 100vh. It owns the page sky and its one nebula sits behind the atlas, never behind the headline.", "acceptance": "At 390×844, the product purpose and primary CTA appear without waiting for animation. At 320px and large text, the hero grows with content rather than clipping it.", "url": "https://simt.space/cosmos-design/web-page#p01" }, { "id": "P02", "title": "Product evidence over decoration", "level": "must", "requirement": "The atlas shows representative activity records, time labels and approximate places. Label illustrative data. Use contour lines and a few weighted nodes to show relationships; do not mimic a production map with fake live participants. Include one real product screenshot or an accessible product walkthrough below the hero.", "acceptance": "Every showcased interaction has an honest response or is a noninteractive figure. No fabricated member counts, testimonials, countdown urgency or unverifiable availability claims.", "url": "https://simt.space/cosmos-design/web-page#p02" } ] }, { "id": "layout", "title": "Responsive composition", "summary": "Keep the visual rhythm while changing the arrangement.", "platform": "web-page", "url": "https://simt.space/cosmos-design/web-page#layout", "rules": [ { "id": "P03", "title": "Grid & navigation", "level": "must", "requirement": "Use a 1200px content maximum, 12 columns expanded, 6 medium and 4 compact. Gutters are 48px at ≥1200, 32px at 768–1199 and 20px below 768. Narrative blocks alternate open field, ruled rows and a single focused evidence panel. Header is 68px minimum with real anchor links; mobile menus are accessible disclosures.", "acceptance": "At 320, 390, 768, 1024 and 1440px no page overflow or collision. Header can grow at large text; anchor headings remain unobscured. At 400% zoom navigation stays reachable.", "url": "https://simt.space/cosmos-design/web-page#p03" }, { "id": "P04", "title": "Type & emphasis", "level": "must", "requirement": "Use display 48–88px expressed in fluid rem, maximum 12–16 words, line-height ≥1.05. Body is 18px at comfortable widths and ≥16px compact. Keep the headline solid Ink; Ember accents one meaningful phrase. Show the primary action in the action gradient; allow a secondary text link with an explicit destination.", "acceptance": "Headline wraps naturally in French and Arabic. No critical information is gradient text or microsized metadata. Equal prominence is not given to every link.", "url": "https://simt.space/cosmos-design/web-page#p04" } ] }, { "id": "atlas", "title": "An atlas that tells the truth", "summary": "Give place and time an understandable structure.", "platform": "web-page", "url": "https://simt.space/cosmos-design/web-page#atlas", "rules": [ { "id": "P05", "title": "Narrative atlas behavior", "level": "must", "requirement": "Use a small inline SVG or pre-rendered image for the public hero, with a nearby text list of representative records. If interactive, use native buttons to select a record and show a labeled detail region; all records work by keyboard/touch. Map controls must have real meaning. Reuse the same selected record in text and visual representations.", "acceptance": "The page remains complete with JavaScript disabled and reduced motion. Selection is visible by label and shape. Decorative geography is marked schematic; exact private coordinates never enter the illustration.", "url": "https://simt.space/cosmos-design/web-page#p05" }, { "id": "P06", "title": "Timelines & categories", "level": "must", "requirement": "Use a horizon ribbon to order real dates or steps, with direct labels and connected milestones. Category color follows common meanings; category filters pair a label with count or selected state. Do not add an auto-scrolling marquee to communicate essential content.", "acceptance": "All milestone and category content is available as text. Horizontal overflow has an obvious scroll or navigation affordance without fading essential labels.", "url": "https://simt.space/cosmos-design/web-page#p06" } ] }, { "id": "conversion", "title": "Confident, calm conversion", "summary": "Make the destination and commitment clear.", "platform": "web-page", "url": "https://simt.space/cosmos-design/web-page#conversion", "rules": [ { "id": "P07", "title": "CTA contract", "level": "must", "requirement": "Primary CTA names the next action and its actual destination. Preserve direct hrefs, keyboard activation and expected new-tab behavior. Explain sign-in or install requirements beside the relevant action. Use no looping CTA pulse, hover-only action, modal interruption or surprise auto-navigation.", "acceptance": "A CTA works without client JavaScript. Track only allowlisted coarse events; never block navigation on analytics. External destinations and download labels match what opens.", "url": "https://simt.space/cosmos-design/web-page#p07" }, { "id": "P08", "title": "Public content & localization", "level": "must", "requirement": "Use one H1, a meaningful H2 outline, semantic landmarks, purpose-based alt text and visible legal/contact links. Localized pages use correct lang/dir, self-canonical URLs and reciprocal hreflang. Dates and assertions have a source/owner; legal copy is maintained independently of promotional language.", "acceptance": "All key text is in the initial HTML, not canvas or image-only type. Arabic reading order and DOM order agree. Each locale has a complete primary journey and no mixed untranslated navigation.", "url": "https://simt.space/cosmos-design/web-page#p08" } ] }, { "id": "delivery", "title": "Fast by construction", "summary": "The atmosphere should be cheaper than the story.", "platform": "web-page", "url": "https://simt.space/cosmos-design/web-page#delivery", "rules": [ { "id": "P09", "title": "Delivery budgets", "level": "must", "requirement": "Target ≤30KiB gzip initial JavaScript, ≤35KiB gzip CSS, ≤120KiB initial font files and ≤250KiB initial hero media. Ship responsive AVIF/WebP with dimensions; load the actual LCP image eagerly and later media lazily. Load no full map engine, animation framework or video before it is requested.", "acceptance": "Check production compression and request waterfall on a cold load. No unused font preload. Measure Core Web Vitals with constrained mobile lab diagnostics and real field cohorts after launch.", "url": "https://simt.space/cosmos-design/web-page#p09" }, { "id": "P10", "title": "Enhancement lifecycle", "level": "must", "requirement": "At most one optional compositor-only ambient hero motion in Full; stop it when out of view or page hidden. Content never starts invisible awaiting an observer. Reduced and data-saving modes show final static compositions. Third-party tags are isolated from critical rendering and governed by the product consent policy.", "acceptance": "No animation-frame loop runs while scrolling the reference page. The first paint remains useful if script fails. Layout shift stays within the shared CLS budget.", "url": "https://simt.space/cosmos-design/web-page#p10" } ] }, { "id": "release", "title": "Web page acceptance", "summary": "Verify the narrative and the real path out of it.", "platform": "web-page", "url": "https://simt.space/cosmos-design/web-page#release", "rules": [ { "id": "P11", "title": "Public release matrix", "level": "must", "requirement": "Verify home, FAQ, legal, locale switch and each CTA at compact/medium/expanded widths; English, French and Arabic; keyboard, screen reader, no-JS, reduced motion and forced colors. Run focused Chromium/Firefox/WebKit checks for shared layout and browser APIs. Test real mobile Safari/Android at release.", "acceptance": "Evidence includes first viewport and full page, link/status checks, metadata parity, accessibility findings and asset budgets. Do not advertise runtime or accessibility conformance based on screenshots alone.", "url": "https://simt.space/cosmos-design/web-page#p11" } ] }, { "id": "shell", "title": "A persistent social field", "summary": "Preserve spatial context without trapping people in a map.", "platform": "web-app", "url": "https://simt.space/cosmos-design/web-app#shell", "rules": [ { "id": "A01", "title": "Shell geometry", "level": "must", "requirement": "At ≥1200px use a 216px labeled rail, flexible discovery field and a 360–420px context pane when selected. At 768–1199px use a 72px rail with accessible names and a 320–360px detail overlay. Below 768px use a 56px top context bar and a ≥64px bottom dock plus safe area. Map/list is a labeled mode switch, not a separate feature implementation.", "acceptance": "Dock and rail show Discover, Inbox, Saved and Profile; create remains one stable primary command. The shell accommodates large text through vertical growth or a labeled collapsed layout, never label clipping.", "url": "https://simt.space/cosmos-design/web-app#a01" }, { "id": "A02", "title": "Context spine", "level": "must", "requirement": "Place location scope, active time/filter summary and result count on one stable context spine. Selected detail begins with identity, date/time, place precision and participation state; the primary action follows those facts. Keep maps mounted across sheets when geography is part of the task, but release inactive hidden routes.", "acceptance": "Closing detail restores the previous selected marker/list row, focus and scroll. Browser back restores context. Filters and result count agree across map and list; manual map exploration never silently turns on follow-location.", "url": "https://simt.space/cosmos-design/web-app#a02" } ] }, { "id": "discovery", "title": "Discover by place, time or people", "summary": "Dense information, with calm priority.", "platform": "web-app", "url": "https://simt.space/cosmos-design/web-app#discovery", "rules": [ { "id": "A03", "title": "Map & list parity", "level": "must", "requirement": "Use Petrol land and Water, warm low-contrast roads and labeled category markers. Clusters show counts, the selected marker gets the quasar aperture and a label, current location shows confidence radius plus text. Render map objects with native map layers/feature state; expose the same authorized results in a semantic list. Location permission is requested only when needed.", "acceptance": "Every meaningful map action has a list/keyboard equivalent. Marker targets expand to 44px; overlaps resolve through clusters or a chooser. Attribution is visible and not covered. Unavailable tiles leave a useful list and retained filters.", "url": "https://simt.space/cosmos-design/web-app#a03" }, { "id": "A04", "title": "Horizon ribbon", "level": "must", "requirement": "Order activity results by actual local start time with visible date groups and explicit time zone when relevant. A compact time ribbon may select a range, paired with an editable date/time control and result summary. Live/stale labels refer to the real data freshness policy, not animation.", "acceptance": "DST, past/current/upcoming and locale dates are correct. Manual keyboard/touch date selection is possible. Zero matches explains the active scope and offers reset without discarding unrelated choices.", "url": "https://simt.space/cosmos-design/web-app#a04" }, { "id": "A05", "title": "Activity record", "level": "must", "requirement": "Display title, date/time, coarse place, role/category, participation/capacity and owner identity in stable tracks. One primary target opens details; Save and other commands are separate controls. Image ratio is 3:2 for a media card; text rows remain a valid low-data representation.", "acceptance": "Long titles wrap to two lines in summary with the full value in detail. Missing images have a purposeful placeholder. Loading, zero results, denied data, offline cached results and removed activities keep a coherent layout.", "url": "https://simt.space/cosmos-design/web-app#a05" } ] }, { "id": "participation", "title": "Honest participation", "summary": "An action is meaningful only when its result is clear.", "platform": "web-app", "url": "https://simt.space/cosmos-design/web-app#participation", "rules": [ { "id": "A06", "title": "Detail & participation states", "level": "must", "requirement": "Design available, pending approval, confirmed, waitlisted, full, cancelled, finished and unavailable states where the backend supports them. Distinguish requesting participation from being accepted. Place consequences, privacy and location precision beside the action. Do not invent a backend capability to satisfy a visual.", "acceptance": "The UI maps each supported server state explicitly; unsupported target capabilities are recorded as contract dependencies. Pending mutation is guarded, failure rolls back safely, and confirmed counts come from authoritative data.", "url": "https://simt.space/cosmos-design/web-app#a06" }, { "id": "A07", "title": "Saved, profile & inbox", "level": "must", "requirement": "Reuse record geometry for Saved; profile opens with identity and authorized roles before activity rows. Inbox separates actionable unread events from history, with text and a leading marker rather than glow. Timeline messages preserve drafts on failure and retain read-only/removed/access-revoked states.", "acceptance": "Read/unread changes update counts consistently. Public profiles are permission-safe. Owner-only controls are absent for other users; denied routes provide recovery without leaking private conditions.", "url": "https://simt.space/cosmos-design/web-app#a07" } ] }, { "id": "composer", "title": "Compose with continuity", "summary": "Keep the idea intact while people solve the details.", "platform": "web-app", "url": "https://simt.space/cosmos-design/web-app#composer", "rules": [ { "id": "A08", "title": "Four-step composer", "level": "must", "requirement": "Use Idea → Moment → Place → Review, an always-readable progress spine and a concise draft summary. Each step validates its owned fields; users can go back without losing safe values. Preserve product capacity/range limits from the real API contract. Show exact/approximate place choice and its audience consequences in Place and Review.", "acceptance": "No false autosave claim: label saved only after the supported persistence succeeds. Draft resume, discard, upload progress/failure, permission denial, version conflict and submit failure are designed. Review displays the exact publish audience and location precision.", "url": "https://simt.space/cosmos-design/web-app#a08" }, { "id": "A09", "title": "Forms & destructive changes", "level": "must", "requirement": "Use a 640px reading/form maximum, stable labels and grouped sections separated by rules. Sticky submit belongs to the form and respects keyboard/safe area. Confirm deletion with object name and consequence, without coercive wording. For stale concurrent edits, present an explicit refresh/review choice and preserve the local draft.", "acceptance": "Submission errors link to fields; network failure retains input. Double activation cannot create two activities. Disabled controls state the unmet requirement when a person can resolve it.", "url": "https://simt.space/cosmos-design/web-app#a09" } ] }, { "id": "operations", "title": "A precise operational console", "summary": "The same palette, with quieter structure and stronger evidence.", "platform": "web-app", "url": "https://simt.space/cosmos-design/web-app#operations", "rules": [ { "id": "A10", "title": "Moderation & administration", "level": "must", "requirement": "Use semantic tables with direct status labels, stable column alignment, consequence summaries and traceable decisions. Separate queue, subject evidence and decision area; never put each cell in a card. Honor the existing desktop-only moderation policy on compact widths with a useful desktop-required explanation.", "acceptance": "Unauthorized tools do not render. Permission revocation fails closed. Conflict, stale evidence, audit failure and terminal state block unsafe actions. Sensitive evidence never appears in public previews, telemetry or exports without authorization.", "url": "https://simt.space/cosmos-design/web-app#a10" } ] }, { "id": "performance", "title": "A responsive working set", "summary": "Responsiveness includes memory, map work and recovery.", "platform": "web-app", "url": "https://simt.space/cosmos-design/web-app#performance", "rules": [ { "id": "A11", "title": "Loading & runtime budgets", "level": "must", "requirement": "Target ≤180KiB gzip initial app JavaScript excluding the deferred map engine, ≤50KiB gzip shared CSS and ≤120KiB initial fonts. Render a useful list/shell before map readiness; defer admin/composer/media code. Bound visible records, images and map sources to the task; virtualization must preserve accessibility, focus and findability.", "acceptance": "On a named baseline device, repeated filter/detail/back cycles do not cause monotonic retained-memory growth. Map and list retain selection. Long tasks are diagnosed; field Core Web Vitals meet common targets before release acceptance.", "url": "https://simt.space/cosmos-design/web-app#a11" }, { "id": "A12", "title": "Secure rendering & recovery", "level": "must", "requirement": "SSR public content and safe shell data only; authenticate before rendering private payloads. Authenticated responses default to private, no-store unless a reviewed isolation policy permits caching. Offline data is shown only when policy permits, with timestamp and safe recovery. Never trade data isolation for instant-looking transitions.", "acceptance": "Multi-account switching cannot reveal previous private data. Rendered errors are localized and safe; technical error IDs may appear only as support metadata. Retry is bounded and cancel/abort is respected.", "url": "https://simt.space/cosmos-design/web-app#a12" } ] }, { "id": "release", "title": "Web app acceptance", "summary": "Ship a complete task slice, including the hard states.", "platform": "web-app", "url": "https://simt.space/cosmos-design/web-app#release", "rules": [ { "id": "A13", "title": "Route matrix", "level": "must", "requirement": "Review sign-in/onboarding, map/list discovery, detail/participation, create/edit, saved, inbox/timeline, profile/settings, account states, share/unavailable and authorized admin routes. Compare 390, 768, 1024 and 1440px, Arabic RTL, large text, forced colors and every motion tier. Exercise keyboard and screen-reader flows with real supported contract fixtures.", "acceptance": "Evidence names the direct composition, build and tested routes. A missing denied/offline/conflict state or inaccessible map-only task blocks the affected feature; unrelated routes are not claimed validated.", "url": "https://simt.space/cosmos-design/web-app#a13" } ] }, { "id": "anatomy", "title": "The instrument field", "summary": "The screen explains its measurement before asking for an action.", "platform": "mobile-app", "url": "https://simt.space/cosmos-design/mobile-app#anatomy", "rules": [ { "id": "M01", "title": "Three useful zones", "level": "must", "requirement": "Compose a native context header, flexible instrument field and bottom command zone. The header names the tool, target and confidence/connection state. The field prioritizes one reading with units and a real reference frame; it owns the screen sky, and its quasar aperture marks the target. The command zone contains the primary action and essential secondary controls above gesture/navigation insets.", "acceptance": "On compact portrait, the reading and command are both reachable. At fontScale 2.0, switch to a scrollable reading/controls composition rather than clipping the dial or shrinking text.", "url": "https://simt.space/cosmos-design/mobile-app#m01" }, { "id": "M02", "title": "Navigation & continuity", "level": "must", "requirement": "Use the existing product destinations and native back stack. Stable destinations may use a bottom bar; tool commands do not become destinations. Preserve target and measurement context across sheets and tool switches where appropriate. Use standard predictive back, native IME behavior and one modal dispatcher.", "acceptance": "System back, gesture back and explicit Back agree. Close dismisses only its layer. Deep links handle missing permission, invalid target and authentication safely and preserve an understandable return path.", "url": "https://simt.space/cosmos-design/mobile-app#m02" } ] }, { "id": "instruments", "title": "Fixed frame, living reading", "summary": "Design instruments that are legible outside a studio.", "platform": "mobile-app", "url": "https://simt.space/cosmos-design/mobile-app#instruments", "rules": [ { "id": "M03", "title": "Compass & bearing", "level": "must", "requirement": "Keep the physical north/reference semantics consistent. A dial may rotate with heading while the target bearing is labeled; define that convention visibly. Use direct cardinal labels, a distinct current-direction pointer, target marker and numeric delta. Reserve Cyan for actual live/location state and Gold for precision.", "acceptance": "Known headings 0/90/180/270 and 359→0 transitions are correct. True/magnetic reference and accuracy are explicit. Arabic changes control order, never the sensor mathematics. No reading is presented as valid during missing/calibrating/stale state.", "url": "https://simt.space/cosmos-design/mobile-app#m03" }, { "id": "M04", "title": "Sky, moon & orrery", "level": "must", "requirement": "Use one inspectable field with selected-body details adjacent, labeled rise/set/time zone and actual visibility conditions. Orbital paths encode real relationships and always have a list/text equivalent. Red mode preserves dark adaptation across menus, tooltips and loading. These fields own no decorative star layer: every mark is data.", "acceptance": "Data timestamps and unavailable calculation states are explicit. Small marks get expanded hit regions or a chooser. Screen readers can select a body and read its principal facts without exploring pixels.", "url": "https://simt.space/cosmos-design/mobile-app#m04" }, { "id": "M05", "title": "Map, tracks & links", "level": "must", "requirement": "Use map-native geometry, visible scale/attribution, trace direction and labeled start/current/end states. Tracking distinguishes running, paused, stopping, saved and failed persistence. A share/link preview makes target precision and audience clear before leaving the device.", "acceptance": "Location denial, coarse-only permission, unavailable tiles, offline coverage, sensor interruption and process restoration all have designed paths. Saving success is based on durable persistence, not an animation finishing.", "url": "https://simt.space/cosmos-design/mobile-app#m05" } ] }, { "id": "components", "title": "Native affordances, Cosmos clarity", "summary": "Keep learned Android behavior and refine its visual hierarchy.", "platform": "mobile-app", "url": "https://simt.space/cosmos-design/mobile-app#components", "rules": [ { "id": "M06", "title": "Component profile", "level": "must", "requirement": "Map semantic tokens into one shared Compose theme. Take mobile radii from the platform mapping: 8dp controls, 10dp secondary inline, 14dp emphasis, 20dp records and 28dp sheets. Standard touch controls are ≥48dp; body text 16sp; supporting 14sp. Prefer native switches, pickers, date/time input and selection semantics over custom gesture-only controls. Haptics are optional and respect system settings.", "acceptance": "All actionable custom drawings expose merged meaningful semantics and explicit actions. Long press and haptics are never the sole means of discovering or confirming a command.", "url": "https://simt.space/cosmos-design/mobile-app#m06" }, { "id": "M07", "title": "Sheets & reach", "level": "must", "requirement": "Detail sheets retain the visible instrument reference; entry forms may expand to full-height. Keep sheet title, close affordance and action track explicit. Apply IME, display cutout, system bar and gesture insets using current platform APIs. Avoid placing a destructive action in the primary thumb position.", "acceptance": "Keyboard opening never covers the focused field or submit. Landscape and largest text keep all actions reachable. TalkBack focus enters and exits layers predictably.", "url": "https://simt.space/cosmos-design/mobile-app#m07" } ] }, { "id": "adaptive", "title": "Adapt to the available field", "summary": "Posture changes should reveal context, not invent another product.", "platform": "mobile-app", "url": "https://simt.space/cosmos-design/mobile-app#adaptive", "rules": [ { "id": "M08", "title": "Window classes", "level": "must", "requirement": "Use available window size, not device model. Below 600dp use one column; 600–839dp uses a rail or tool/content split when content fits; ≥840dp shows instrument plus context/detail. Short landscape prioritizes reading and compact commands side by side. Keep semantic reading order continuous.", "acceptance": "Verify 360×800dp, 600×960dp, 840×900dp and 800×360dp plus resizing. No mandatory pane narrower than its readable minimum; fold hinges never cover controls.", "url": "https://simt.space/cosmos-design/mobile-app#m08" }, { "id": "M09", "title": "Fold & posture", "level": "must", "requirement": "For a supported tabletop posture, place the instrument above the hinge and controls below; for a book posture place field and details on separate usable panes. Detect posture from the supported window API and provide a single-pane fallback. Do not claim a posture is implemented solely because the layout is drawn here.", "acceptance": "Posture changes retain target, selection and safe draft state. Real hinge and emulator checks confirm separation; absent detection falls back to width-based layout.", "url": "https://simt.space/cosmos-design/mobile-app#m09" } ] }, { "id": "sensors", "title": "Accurate data, humane permissions", "summary": "Show people how much to trust a reading.", "platform": "mobile-app", "url": "https://simt.space/cosmos-design/mobile-app#sensors", "rules": [ { "id": "M10", "title": "Sensor presentation contract", "level": "must", "requirement": "Separate acquisition rate, computation and UI sampling. Select rates from tool accuracy needs; render at most once per display frame and throttle values that need not update at that rate. Show source, freshness and confidence. Visual damping must be bounded and must not change stored measurements or claim precision beyond the source.", "acceptance": "Test unavailable sensor, interference, calibration, stale samples, lost GPS and restored source. TalkBack announces on request or meaningful coarse changes, not every sample. Pausing the UI does not falsify an ongoing recording indicator.", "url": "https://simt.space/cosmos-design/mobile-app#m10" }, { "id": "M11", "title": "Permissions & privacy", "level": "must", "requirement": "Ask for permission at the point of need with the outcome explained. Design granted, approximate/coarse, denied, permanently denied and unavailable states. Background acquisition is limited to explicit user-owned tasks with platform-required indication and a stop control. Store/export precise data only within the product privacy policy.", "acceptance": "Permission revocation during use resolves safely. Settings recovery has a clear path back. Analytics and support output contain no coordinates, sensor payloads, private target labels or draft text.", "url": "https://simt.space/cosmos-design/mobile-app#m11" } ] }, { "id": "performance", "title": "Native performance contracts", "summary": "A beautiful reading should not compete with the sensor.", "platform": "mobile-app", "url": "https://simt.space/cosmos-design/mobile-app#performance", "rules": [ { "id": "M12", "title": "Frame & startup acceptance", "level": "must", "requirement": "On a named lowest-supported physical device, meet the active display deadline: 16.67ms at 60Hz, 11.11ms at 90Hz, 8.33ms at 120Hz. Target <5% janky frames in a repeatable 30-second instrument/map journey. Target cold first-useful frame ≤1.5s and warm ≤500ms for offline-capable tools, measured with Macrobenchmark; network content reports a separate readiness metric.", "acceptance": "Record device, OS, refresh rate, thermal state, build and traces. No main-thread I/O or per-frame path/particle allocation. The benchmark includes real input and sensor fixtures; a static screenshot does not prove pacing.", "url": "https://simt.space/cosmos-design/mobile-app#m12" }, { "id": "M13", "title": "Lifecycle & memory", "level": "must", "requirement": "Cache static paths/gradients and compose with stable models. Subscribe to sensor presentation only for the active lifecycle; release hidden map/media resources. Reduce cosmetic work first under battery saver/thermal pressure. Persistent recording follows its explicit service contract and does not depend on a visible composable.", "acceptance": "Repeated tool/sheet navigation does not grow retained allocations. Background/foreground and process death preserve only the intended durable state. Red/Reduced/Static do not affect saved data or task availability.", "url": "https://simt.space/cosmos-design/mobile-app#m13" } ] }, { "id": "release", "title": "Mobile acceptance", "summary": "Verify real instruments on real hands and hardware.", "platform": "mobile-app", "url": "https://simt.space/cosmos-design/mobile-app#release", "rules": [ { "id": "M14", "title": "Native release matrix", "level": "must", "requirement": "Review compass, target detail/link, map, sky/moon/orrery, tracking, toolkit, settings, permissions and share flows. Test light/dark/red where supported, compact/expanded/landscape/fold, Arabic RTL, fontScale 2.0, TalkBack, switch access, motion tiers, low power and sensor/permission failure.", "acceptance": "Capture screenshots and traces from supported physical devices, plus adaptive emulators. Compile, instrumented navigation/semantics tests and focused Macrobenchmark evidence are required for implementation acceptance.", "url": "https://simt.space/cosmos-design/mobile-app#m14" } ] }, { "id": "glance", "title": "The single-glance contract", "summary": "Simplicity is a platform requirement.", "platform": "watch-app", "url": "https://simt.space/cosmos-design/watch-app#glance", "rules": [ { "id": "W01", "title": "One answer per screen", "level": "must", "requirement": "Show one primary value/subject, one short qualifier and one primary action or clear route to it. Use no glass blur, decorative stars, ambient drift, dense map, paragraph card or phone-style bottom dock. Retain Void and the same signal colors in interactive mode; corona is the only gradient a watch screen may use, as one static halo on the bearing or target marker, never under text, and a one-accent screen is valid.", "acceptance": "The compass communicates direction and confidence immediately. The sky communicates the selected body and next event. The geofence communicates target distance/state. Additional facts require a deliberate tap/scroll.", "url": "https://simt.space/cosmos-design/watch-app#w01" }, { "id": "W02", "title": "Round geometry", "level": "must", "requirement": "Design for 192dp and 228dp round viewports plus the minimum supported device. Place critical content inside a safe central area. At vertical offset y from center, available width is 2√(r²−y²) minus at least 12dp each side; avoid generic rectangular edge padding. Bottom commands use the native edge button/scaffold.", "acceptance": "No text, hit region or action is clipped by the circular boundary at the largest supported font. If content does not fit, flow it into a native scaling/transforming scroll list.", "url": "https://simt.space/cosmos-design/watch-app#w02" } ] }, { "id": "type-input", "title": "Readable and reachable", "summary": "A small display still deserves full-sized targets.", "platform": "watch-app", "url": "https://simt.space/cosmos-design/watch-app#type-input", "rules": [ { "id": "W03", "title": "Type & controls", "level": "must", "requirement": "Use 32–40sp primary readings, 18–20sp titles, 14–16sp body/control labels and 12–14sp secondary qualifiers. Keep units visible beside the reading. Touch targets are ≥48dp, with nonoverlapping geometry and at least 4dp separation where feasible. Use native Wear typography and components mapped to Cosmos roles.", "acceptance": "Largest system text preserves values, units and actions through reflow/scroll. A short label may have an accessible expanded name; truncation cannot hide the primary reading, qualifier or destructive consequence.", "url": "https://simt.space/cosmos-design/watch-app#w03" }, { "id": "W04", "title": "Rotary & assistive input", "level": "must", "requirement": "Use rotary input for native list scrolling and appropriate value adjustment; expose focus/state and a touch alternative. Keep system swipe-back behavior. Long press is optional, never the sole route. TalkBack receives one coherent instrument description with an explicit refresh/read action.", "acceptance": "Touch, rotary and TalkBack complete each essential task. Rotary focus is acquired and released with the active screen. Sensor updates do not flood announcements.", "url": "https://simt.space/cosmos-design/watch-app#w04" } ] }, { "id": "screens", "title": "A small set of useful tools", "summary": "Each tool has one recognizable visual structure.", "platform": "watch-app", "url": "https://simt.space/cosmos-design/watch-app#screens", "rules": [ { "id": "W05", "title": "Home & targets", "level": "must", "requirement": "Home is a short native list of Compass, Sky, Geofence, Plumb bob, Targets and Settings where supported. Use an icon, literal name and useful last-state qualifier; category color is secondary. Targets is a bounded readable list with selected state and a detail route. Empty targets offers a clear phone-sync or add path supported by the product.", "acceptance": "No orbit carousel or icon-only launch grid. The top item is readable immediately on entry and the last item is reachable by touch/rotary. Synced state is honest about connectivity and freshness.", "url": "https://simt.space/cosmos-design/watch-app#w05" }, { "id": "W06", "title": "Compass & plumb bob", "level": "must", "requirement": "Compass uses a simplified dial with no more than four cardinal labels, a clear bearing pointer and one numeric value. Confidence appears as text/icon. Plumb bob uses a stable center/level frame and explicit tilt units. Use no extra precision ticks that compete with the reading.", "acceptance": "Known heading/tilt fixtures render correctly, including wrap-around. Calibrating/unavailable/stale states replace the value with honest status; a tap can expose calibration or target selection.", "url": "https://simt.space/cosmos-design/watch-app#w06" }, { "id": "W07", "title": "Sky & geofence", "level": "must", "requirement": "Sky shows one selected body with next rise/set event and a concise availability state; the full catalog is a separate list. Geofence shows selected target, distance and inside/outside/unknown state. Cyan denotes actual located/live state, not the entire tool theme. Keep the same canonical Cyan; migrate the legacy watch-specific cyan through theme roles.", "acceptance": "Indoor/no-fix/offline/stale and revoked permission states cannot resemble a valid lock. The text names the state, and haptic alerts are supplementary, user-controlled and deduplicated.", "url": "https://simt.space/cosmos-design/watch-app#w07" } ] }, { "id": "ambient", "title": "Ambient is a different composition", "summary": "When the wrist rests, the interface rests too.", "platform": "watch-app", "url": "https://simt.space/cosmos-design/watch-app#ambient", "rules": [ { "id": "W08", "title": "Always-on state", "level": "must", "requirement": "Provide an explicit ambient layout: pure black background, a sparse muted reading, no filled surfaces/gradient/glow, no seconds, no animation and no touch affordances implying interactivity. Mark the reading time if frozen. Honor low-bit and burn-in requirements and platform-recommended repositioning; ambient is not a dimmed interactive screenshot.", "acceptance": "Verify the real ambient lifecycle and supported hardware. UI updates follow platform ambient cadence; no UI frame loop runs. Any background sensing/geofence monitoring is separately justified by the user task and power policy.", "url": "https://simt.space/cosmos-design/watch-app#w08" }, { "id": "W09", "title": "Wake & confidence", "level": "must", "requirement": "On return to interactive mode, display the last value as stale until a fresh valid sample arrives. Restore target and navigation state; never flash a bright intermediate surface. A watch face complication/tile exposes only supported concise public-safe facts and opens the corresponding task.", "acceptance": "Stale becomes fresh only on new evidence. Interrupted connection and missing phone do not discard the current task. A complication never leaks private target text or exact coordinates without the product authorization.", "url": "https://simt.space/cosmos-design/watch-app#w09" } ] }, { "id": "performance", "title": "Battery is part of UX", "summary": "Remove work that cannot help the person.", "platform": "watch-app", "url": "https://simt.space/cosmos-design/watch-app#performance", "rules": [ { "id": "W10", "title": "Runtime & energy acceptance", "level": "must", "requirement": "Use no WebView or phone-scale map engine. Cache static dial geometry; stop presentation subscriptions when hidden and never allocate decorative paths per frame. Target <5% janky frames in a named 30-second interactive journey at the device refresh rate. First useful offline reading should appear ≤1s cold on the baseline watch. Use explicit timeouts for acquisition and phone-sync work.", "acceptance": "Record physical watch, OS, refresh rate, build, thermal state and trace. Ambient rendering has zero continuous animation callbacks; retained memory does not grow across repeated tool navigation.", "url": "https://simt.space/cosmos-design/watch-app#w10" }, { "id": "W11", "title": "Power validation", "level": "must", "requirement": "Measure a repeatable 30-minute interactive/ambient scenario with fixed brightness, connectivity and sensor policy. Record total drain, incremental cost versus a same-build task-disabled baseline and the approved product battery budget before release. Do not publish an invented universal mAh or percentage promise.", "acceptance": "A named owner approves the observed budget on physical hardware. Low power disables ornament first; stopping a user-owned monitoring task requires an explicit visible reason rather than silent disappearance.", "url": "https://simt.space/cosmos-design/watch-app#w11" } ] }, { "id": "release", "title": "Watch acceptance", "summary": "Check the smallest device, largest text and resting wrist.", "platform": "watch-app", "url": "https://simt.space/cosmos-design/watch-app#release", "rules": [ { "id": "W12", "title": "Wear release matrix", "level": "must", "requirement": "Verify home, compass, sky list/detail, geofence, plumb bob, targets and settings in interactive, ambient, low-bit/burn-in where supported, offline and no-phone states. Include 192/228dp, largest text, Arabic, touch, rotary, TalkBack, permission/sensor failure and low battery.", "acceptance": "Physical-device screenshots, lifecycle traces, focused instrumentation and power measurements are required for implementation acceptance. Round emulator screenshots alone do not certify glanceability, comfort or battery behavior.", "url": "https://simt.space/cosmos-design/watch-app#w12" } ] } ] }