Overview

This module enables a filesystem allowing ZenFS to be implemented in each theme or app.

Features

• Implements a Node.js-like filesystem using ZenFS
• Allows different mounts like temp folders and zip files
• External file import via utilExternalFileImport (OS drop → ZenFS write)
• Internal path moves via movePathsToDirectory (used by kit-fs drag-and-drop)

Installation

pnpm desktop add @owdproject/module-fs

With in-app documentation, install @owdproject/module-docs before this module in desktop.config.ts so FS docs pages are registered (/docs/modules/filesystem/...).

Configuration

You could set this configuration in /desktop/desktop.config.ts:

fs: {
  mounts: {
    '/music/meteora': '/meteora.zip',
    '/home': 'WebStorage',
    '/tmp': 'InMemory',
  },
},

If you are mounting zips, place them in your /desktop/public folder (served as /filename.zip from the app root, or under app.baseURL if you use a subpath). The module fetches the file on the client and rejects non-zip responses (e.g. HTML 404) before mounting.

If you see “could not locate End of Central Directory signature”, the downloaded bytes are not a valid ZIP (wrong URL, 404 page, empty file, or corrupt archive).

Explorer drag and drop

When paired with @owdproject/kit-fs:

| Utility / API | Role | |---------------|------| | runtime/utils/utilExternalFileImport.ts | Parse DataTransfer (files, folders, image URLs) and write into ZenFS | | runtime/utils/utilExplorerMove.ts | Path guards for internal moves (isInvalidMoveTarget) | | useFileSystemExplorer.importExternalFiles(entries, targetDir?) | Import into current or target directory | | useFileSystemExplorer.movePathsToDirectory(paths, targetDir) | Move VFS entries (internal drag) |

License

This module is released under the MIT License.