Web compatibility
The runtime has its own renderer (it is not Chromium), and page JS runs in its embedded V8. The rule is that standard APIs are fully browser-compatible: behavior, signatures, events, and errors all follow the spec. Anything that can't be done that way is a gap; it is not filled with a look-alike proprietary version. Below are the things worth knowing.
Origin
Section titled “Origin”Every app page has the origin http://acde.local. Each app's storage is a separate partition, invisible to other apps.
Storage
Section titled “Storage”| API | Notes |
|---|---|
localStorage |
Shared by all windows of the same app; 5 MiB quota; other windows get a storage event on changes |
sessionStorage |
Per window, in memory only; not kept across location.reload() (unlike browsers) |
| IndexedDB | Fully implemented, stored in SQLite; promise-wrapper libraries (idb and others) behave as in browsers |
| Cache API | caches is supported |
| cookie | Stored and sent as usual for same-origin requests (your own backend); cross-origin requests neither send nor store cookies |
navigator.storage |
estimate(); persist() is always true; getDirectory() is the origin private file system (OPFS) |
Data lives in $XDG_DATA_HOME/acde/storage/app-<id>/.
Network
Section titled “Network”fetch,XMLHttpRequest,WebSocket, andEventSourceare all supported.- Same-origin paths and
localhostgo to the app's own backend; see Backend. - Requests to other hosts use the system's DNS and network, with normal certificate validation, and go through a proxy the way the system says: with
http_proxy,https_proxyorall_proxyset in the session, only those variables (andno_proxy) count; otherwise the system's proxy settings (Windows: the user's Internet settings, including a configuration script and automatic detection; macOS: the network settings; Linux has no other source).localhost, loopback addresses and the app's own backend are always reached directly. Proxy authentication andhttps://proxies are not supported. Responses are not decompressed automatically (noAccept-Encodingis sent). - Cross-origin requests follow browser rules:
Originheader, CORS preflight, response header filtering, opaque responses forno-cors. - Forbidden request headers (
Host,Cookie,Origin,Referer,Sec-*, ...) are not sent even if you set them. - Synchronous XHR can only read the app's own files.
External resources
Section titled “External resources”Images (<img> and images in CSS), stylesheets (<link rel="stylesheet">) and fonts load from other hosts as they do in a browser: images and stylesheets without CORS, fonts only with an Access-Control-Allow-Origin that allows the page, a stylesheet only from a 2xx text/css response. They show up in acdev network with the kinds image, stylesheet and font, and a failed one is a console error Failed to load resource: <url>: <reason>. A <link rel="stylesheet"> fires load once its sheet is fetched and applied and error when it cannot be had (also when a sheet it @imports cannot); link.sheet and document.styleSheets have the sheet from then on. The rules of a sheet from another host (sheet.cssRules) throw SecurityError unless the link has crossorigin and the host allows the page with Access-Control-Allow-Origin; its @font-face faces are still in document.fonts. ES modules can't be imported from other hosts (module … is not a local file): bundle the code you depend on into the app. blob: and data: modules can be imported when their type is a JavaScript MIME type (text/javascript). (Classic <script src> can load from other hosts.) An app that should work without a network bundles its images, styles and fonts too.
Scripts
Section titled “Scripts”Classic <script>, type="module", and type="importmap" are supported.
File pickers
Section titled “File pickers”showOpenFilePicker, showSaveFilePicker, showDirectoryPicker, and <input type="file"> open the system dialog; see Files and folders.
Files and folders dropped into a window arrive the standard way: dataTransfer.files, and a read-only handle from dataTransfer.items[i].getAsFileSystemHandle(). Folders and files over 64 MiB are not in files; use the handle. See Dropped files.
Audio / AudioContext are supported, and so are OfflineAudioContext (one or two channels, no suspend()), the effect nodes (biquad, delay, wave shaper, compressor, convolver, analyser) and custom PeriodicWaves; ChannelSplitterNode, ChannelMergerNode, IIRFilterNode and AudioWorklet are not there yet. WebGPU is currently available only on Linux.
<video> plays what the system's own decoders can open, so formats differ by platform: on macOS, MP4 / QuickTime plays and WebM does not. Ask canPlayType() before choosing a source.
navigator.mediaDevices.getUserMedia() needs the camera / microphone capability in the config and the user's answer the first time (see Capabilities). Not available on Windows.
- A required capability is asked for on first use, and a denial only fails the calls. An optional one that was not asked for yet is asked for by
getUserMedia()itself, with the promptrequest('camera')raises; a call that wants both asks for the microphone first, then the camera. The call resolves once the user allows and rejects withNotAllowedError(Permission denied) when the user denies; later calls do not ask again. navigator.permissions.query({ name: 'camera' })(or'microphone') answerspromptuntil the user has answered anddeniedafter a denial or after the approval was taken back; itschangeevent fires on the answer. Once the user has allowed it, the answer is the host system's own permission for the device (grantedwhen the system allows it too).- In an app that does not declare the capability, the query answers
deniedandgetUserMedia()rejects withNotAllowedError, without a prompt. - Constraints are judged first: a request that no device can meet rejects with
OverconstrainedErrorand asks nobody. enumerateDevices()lists one entry without a label for a kind that is not allowed yet.- To try a page without a real camera or microphone, start the session with
ACDE_CAPTURE=fake: the devices are thenFake cameraandFake microphone.
Rendering and canvas
Section titled “Rendering and canvas”Styles are computed by Stylo, the style engine of Firefox; layout and painting are libacde's own. What does not work yet:
- Canvas 2D:
drawImage()draws only an<img>or a<canvas>; any other source (a<video>, anImageBitmap) draws nothing and throws nothing.createConicGradient()does not draw a conic gradient.ctx.filtertakesblur(),brightness(),contrast(),grayscale(),hue-rotate(),invert(),opacity(),saturate(),sepia()anddrop-shadow(), but noturl(). - WebGL: transform feedback (
beginTransformFeedbackfails withINVALID_OPERATION), uploads and reads throughPIXEL_PACK_BUFFER/PIXEL_UNPACK_BUFFER,EXT_disjoint_timer_query, and uploading data toDEPTH_COMPONENT24/DEPTH32Ftextures (only 16-bit depth takes data). Images from other hosts can be read back (no origin-clean check, as in 2D canvas), and a lost context is not restored (restoreContext()does nothing). - SVG geometry:
getTotalLength()andgetPointAtLength()are estimates from the element's box, not its path;isPointInFill()andisPointInStroke()are alwaysfalse.
These work as in browsers:
- WebGL 1 and 2:
getContext('webgl')andgetContext('webgl2')give a context on every system, drawn with the same GPU as the page (three.js and pixi work), with the exceptions above. - Inside an inline
<svg>, shapes, text and groups have their boxes (getBBox(),getBoundingClientRect()), andgetComputedTextLength()measures text. - Canvas 2D draws SVG images.
<use href="#id">andurl(#id)that point into another<svg>of the page (a sprite sheet, a shared gradient) work.- On macOS,
font-family: monospaceis Menlo, as in Safari and Chrome. The system supplies a font for symbols that no font in the stack has (✕✔❤), andfont-weight: 700of a font with only a regular face is synthesized. :has()selectors (Tailwind'shas-*variants).animationstart,animationiteration,animationend,animationcancel,transitionrun,transitionstart,transitionendandtransitioncancel(dialogs and menus that wait foranimationendbefore they unmount).- A
<textarea>'sscrollHeightcovers its text, andfield-sizing: contentgrows the box with it. new Image()with asrcloads (and firesload/error) without being in the document.- Inline SVG colors given as
oklch(),lab()orcolor-mix()(Tailwind 4's palette) are painted. - In SVG images and inline SVG, a
<mask>made of one filled path clips to it (other masks clip to their region), and a groupfiltermade of blurs, drop shadows and color matrices is applied (the glow of icons exported from Figma). - An element with an
idis reachable as a global (window.wave). pointer-events: alland the other SVG values (visible,painted,fill,stroke…) are understood and act asauto.- An SVG image used as a
background-imageormask-imageis drawn. - An inline
<svg>without aviewBoxdraws its content in CSS pixels from its top left, and clips it to its box, as browsers do. <input>and<textarea>have undo and redo:Ctrl+Z, andCtrl+Shift+ZorCtrl+Y.
Not yet supported
Section titled “Not yet supported”<datalist>, appearance: base-select on <select>, SharedWorker, a MessagePort sent to a worker and SharedArrayBuffer (dedicated workers work), crypto.subtle, OffscreenCanvas / createImageBitmap, the Fullscreen API (requestFullscreen() rejects with NotSupportedError; an app window goes full screen with requestState('fullscreen') from acde:window), :target, Storage Buckets, and Service Workers.
Differences from browsers
Section titled “Differences from browsers”alert()is drawn inside the window;confirm()returnsfalseandprompt()returnsnull.- There is no top layer: an open popover and a modal
<dialog>get the highestz-indexinstead, so an ancestor'stransform,filterorcontainstill clips them, and they have no::backdrop. navigator.userAgentandnavigator.platformsay Linux on every system (Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) acde/<version>andLinux x86_64), and editing shortcuts use Ctrl everywhere, so an app behaves the same on every host. To know the real system, readplatformfromacde:capabilities.- Besides the debugging tools and MCP,
acdev devopens the DevTools of Chrome or Edge on a page (F12 in the window, oracdev devtools); see acdev dev. - Pages have no security sandbox (there is no syscall-level isolation yet): don't run code you don't trust.