Manaurum Platform v2
Design guidelines
App content follows Smoothie, light/dark appearance and the selected accent. XP belongs to shell chrome.
Contracts reviewed: · SDK version: 2.6.1
Theme on the root element
Apply theme, appearance, accent, lang and dir to document.documentElement at readiness and on changes. onThemeChange passes only theme; read the other current values from app.context. Accent is a name such as core-blue, not a CSS color: map names to colors or consume the UI tokens. Use the same lifecycle example as the SDK section.
import { ManaurumV2 } from 'https://manaurum.com/sdk/manaurum-v2.mjs';
const app = ManaurumV2.init();
const applyContext = () => {
const ctx = app.context;
if (!ctx) return;
const root = document.documentElement;
root.dataset.theme = ctx.theme;
root.dataset.appearance = ctx.appearance;
root.dataset.accent = ctx.accent;
root.lang = ctx.locale || navigator.language;
root.dir = ctx.dir || (root.lang.startsWith('he') ? 'rtl' : 'ltr');
};
app.onReady(applyContext);
app.onThemeChange(applyContext);
app.onLocaleChange(applyContext);Readable and accessible content
Use the UI library and examples. Its catalog changes over time, so refer to the catalog rather than a fixed component count. Prefer readable body text, sufficient contrast, visible focus, selectable text, labeled controls and touch targets of at least 44 px. Translate system UI to English, Russian and Hebrew; support RTL while keeping code and identifiers LTR. Respect reduced-motion preferences.
Window and scroll rules
The shell supplies window chrome; the app fills its content area. Window dimensions are hints and can change. Give any internal scroll area a bounded height and min-height: 0; overflow: auto alone cannot scroll an auto-height block. Keep document text flexible, and put horizontal overflow only around code or tables. Test narrow windows as well as full-screen phones, both orientations, the notch and browser toolbar.
:root { --accent: #0058bc; --bg: #fff; --text: #1d1d1f; }
:root[data-appearance="dark"] { --bg: #1c1c1e; --text: #f5f5f7; }
:root[data-accent="rose"] { --accent: #ff6ca0; }
html, body { margin: 0; min-height: 100%; }
body { background: var(--bg); color: var(--text); }
pre { overflow-x: auto; max-width: 100%; }