Documentation
Public Alpha developer entry for DnDGem. Source repository remains private; this site is the canonical public home.
Start here
-
Quick Start — first React layout with
@alpha - Playground — interactive VALID / DEGRADED demo
- Support — product feedback and security contacts
Install
npm install @dndgem/react@alpha
npm install @dndgem/dom@alpha
Official channel is @alpha → 0.1.0-alpha.0. Do not treat
latest as a stable release channel.
Package overview
| Package | Role |
|---|---|
@dndgem/core |
Renderer-agnostic constraints, validity, scoring, solver |
@dndgem/dom |
DOM measurement, resize, drag, Vanilla layout session |
@dndgem/react |
React provider + hooks (peer: react@^18 || ^19) |
Core distinction
GEOMETRICALLY FITS ≠ CONTENT REMAINS USEFUL
Layouts are selected deterministically. Engine status is VALID, DEGRADED, or INVALID.
Browser support (Alpha)
- Chromium — supported for Alpha
- Firefox — supported for Alpha
- WebKit — supported for Alpha
- Mobile — not validated
Accessibility baseline
- Supported: pointer drag, Escape cancellation, baseline focus, consumer ARIA preservation
- Deferred: keyboard drag, screen-reader drag announcements
- Known: visual order may differ from DOM / tab order under absolute positioning
- Not claimed: full WCAG conformance
Known limitations
- 0.x Alpha API may break between prereleases
- Full SSR / hydration not validated
- Auto-Layout, AI, Flutter, and other framework adapters not implemented
- Large-N behavior not established
- Absolute-positioning rendering model