Assets and icons
public/
Section titled “public/”The project's public/ directory (rename it with the public config field) is copied as is into the app's web/.
References in your pages that start with / and point to a file in public:
- In HTML: bundled as usual.
url(/x)in CSS: kept as is when the project is an app whose entry is HTML, because the runtime also serves the app's directory at/. Elsewhere (a desktop, or the apps it bundles) it is bundled as usual.- If the file can't be found anywhere, the build fails and tells you which URL in which file, and what's missing from public.
Files your scripts refer to
Section titled “Files your scripts refer to”A file that only your JavaScript names is bundled one of these ways:
import logo from './logo.png':logois its URL in the built app.new URL('./logo.png', import.meta.url): the file is copied and the URL points at it (with Node.js, Vite does this; with Bun, acdev does it). The path must be a literal that starts with./or../and names a file that exists; a module (.js,.ts, …) is left alone.- A path in a string (
img.src = 'img/logo.png') is not seen by any bundler: put the file inpublic/and refer to it as/img/logo.png.
App pages have the origin http://acde.local. An app's files are served both under /app/<id>/ and at /, so /logo.png and relative paths both work.
Set icon to an icon name or to an image in the project:
{ "icon": "chart" } // icon name{ "icon": "assets/logo.svg" } // image in the projectIcon names refer to Dopame's built-in icon set, which matches the desktop's visual style:
files browser editor office term projects dash team dopa settings store app timer cards list chart calc music video photo paint game chat mail calendar code book map weather
If omitted, it's app.
Images: a value that contains / or \, or has an extension, is treated as a path relative to the project directory, and must be a .svg or .png. At build time it's copied to the app's web/icon.<ext>, and the manifest gets /app/<id>/icon.<ext>. acdev check warns about any other value.