Skip to content
@SurfaceWorks

SurfaceWorks

SurfaceWorks — an accessible UI layer for self-describing control surfaces

SurfaceWorks gives a product a face without the product writing a UI. Any product that exposes a control plane and publishes a self-describing control surface (a CommonTongue SurfaceDescriptor) can be rendered here: SurfaceWorks turns that description into a live, accessible interface — generically, with no product-specific code. Camera daemons, light controllers, and control decks are the first consumers, but the contract is open — anything that can describe its controls can be rendered.

The pieces

  • Lucidity — the reference renderer. Reads a SurfaceDescriptor and builds an accessible web UI. One renderer for every product; the descriptor privileges none (others may exist).
  • Palette — the widget vocabulary. The recommended, extensible catalogue of the control widgets a renderer draws — sliders, knobs, gauges, colour wheels, key-grids, trackballs, meters. A vocabulary, not code.
  • Codex — the role vocabulary. The recommended, extensible catalogue of cross-vendor control meaningsbrightness, aperture, illuminance, pan, macro_trigger — so renderers and aggregators understand "the same control" the same way across brands.

Codex and Palette are recommended, not required, and grow by PR — align to them for interop across the wider ecosystem, or roll your own (x.<vendor>.* / a custom widget) and still render.

North Stars (in order)

Accessibility · Ease-of-use · Speed · Choice. Accessibility is first, not a retrofit: a control that can't be operated by keyboard and screen reader, or whose meaning lives in colour alone, does not ship.

Built by reference, never by copy

SurfaceWorks defines no wire standards of its own. It consumes the SurfaceDescriptor contract from CommonTongue and conforms to the shared substrate published by CommonPractices (CommonMind, blueprints) — incorporated by reference, never restated here.

Contributions welcome from anyone. See the org's CONTRIBUTING, and open an issue before anything non-trivial.

Popular repositories Loading

  1. .github .github Public

    SurfaceWorks — org community health files + profile.

  2. Lucidity Lucidity Public

    Lucidity — the reference control-surface renderer.

  3. Palette Palette Public

    Palette — the family's control-widget vocabulary.

    Python

  4. Codex Codex Public

    Codex — the family's control-role vocabulary.

    Python

Repositories

Showing 4 of 4 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…