SpawnDev.WebFS 1.0.0

SpawnDev.WebFS

SpawnDev.WebFS lets Blazor WebAssembly web apps host a file system via a domain labeled folder by connecting to the SpawnDev.WebFS.Host app running on the user's PC.

SpawnDev.WebFS.Tray

<img width="48" src="https://github.com/LostBeard/SpawnDev.WebFS/raw/refs/heads/master/SpawnDev.WebFS/wwwroot/webfs-128.png" />

The SpawnDev.WebFS.Tray app runs on the user's PC with an icon in the system tray and can optionally start with Windows. While running, the WebFS host app uses DokanNet to mount a new drive on the user's PC that can be accessed normally by any apps on the user's computer. Websites can request permission to provide a file system via a domain labeled folder on the root of the new drive.

WebFS Tray Download: SpawnDevWebFSSetup

WebFS Providers

Website file system provider links and descriptions.

lostbeard.github.io - Demo WebFS Provider

Demonstrates WebFS by providing read and write access to the browser's Origin private file system.

Use cases

• A website that allows protected access to a remote encrypted file system.
• Team collaboration on shared projects.
• Browser extension that provides access to Google Photos through a folder by automating Google Photos in a browser page.
• Access files and folders on your remote devices anywhere using normal apps.
• Etc.

Using SpawnDev.WebFS in a Blazor WebAssembly app

WebFS tray app

The WebFS tray app is required for both development and production use. In development, it may be more useful to use the source project in this repo instead.

Blazor WebAssembly

• Add a reference to the latest SpawnDev.WebFS Nuget package using your method of choice.

Program.cs - From demo repo

using Microsoft.AspNetCore.Components.Web;
using Microsoft.AspNetCore.Components.WebAssembly.Hosting;
using SpawnDev.BlazorJS;
using SpawnDev.WebFS;
using SpawnDev.WebFS.Demo;

var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.RootComponents.Add<App>("#app");
builder.RootComponents.Add<HeadOutlet>("head::after");

// Add SpawnDev.BlazorJS JS  interop
builder.Services.AddBlazorJSRuntime(out var JS);

// Registers WebFSProvider, the demo WebFS provider as WebFSProvider and IAsyncDokanOperations
// Registers WebFSClient which connects to the tray app when its Enabled property is set to true
builder.Services.AddWebFS<WebFSProvider>();

// Startup using BlazorJSRunAsync
await builder.Build().BlazorJSRunAsync();

• Implement the IAsyncDokanOperations interface in your custom provider and set WebFSClient.Enabled = true when ready
  WebFSProvider.cs - From demo repo

    /// <summary>
    /// Demo WebFS filesystem provider.<br/>
    /// Provides access the the browsers Origin private file system.<br/>
    /// IBackgroundService sets this service to autostart when the Blazor WASM web app loads
    /// </summary>
    [RemoteCallable]
    public class WebFSProvider : IAsyncDokanOperations, IBackgroundService
    {
        public WebFSProvider(BlazorJSRuntime js, WebFSClient webFSClient)
        {
            JS = js;
            WebFSClient = webFSClient;
            // this demo provider uses navigator.storage to provide access to the browser's origin private file system
            using var navigator = JS.Get<Navigator>("navigator");
            StorageManager = navigator.Storage;
            // tell WebFSClient to connect to the tray app when it can
            WebFSClient.Enabled = true;
        }

WIP

If you are interested in this project, please start an issue to suggest features or areas of interest.