Documentation

Learn Visual Spec

Start with the motivation, then move through concepts, profiles, validation and adapter guidance.

Learn

Why Visual Spec?

Visual intent deserves a persistent, portable contract.

why
Quick start

Write, validate and explore your first visual contract.

quick-start
The mental model

A few independent models describe one visual experience.

concepts
Profiles

Nine specializations, one shared visual model.

profiles
Component ontology

Reuse semantic patterns, not rectangles or framework names.

components
Worlds, entities and scenes

Keep identity stable as representation and viewpoint change.

entities

Specification

Visual references

Address evidence precisely and preserve what it actually proves.

visual-references
Conformance and validation

Separate a well-formed document from a verified rendering.

conformance
Extensions and namespaces

Extend the vocabulary without changing the meaning of the core.

extensions
Versioning and migration

Pin contracts and make transformations reproducible.

versioning

Guides

Build an adapter

Translate visual intent while making capability boundaries visible.

adapter-guide
Accessibility is a contract

Meaning, names, focus and keyboard behavior travel with the visual model.

accessibility
Motion, state and time

Describe the change, its cause and its interruption policy.

motion
Rendering and visual verification

Specify the conditions before judging the result.

rendering
Contribute to Visual Spec

Improve the contract, examples and interoperability evidence.

contributing