NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #3592 most downloaded on pub.dev
A portable file system implementation working on io, web (OPFS or IndexedDB) and memory
Latest stable
2.7.1
Last release 13 days ago
09 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Some releases are documented
notes for 31 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
11 years old
107 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
fs_shim 2.7.1: idb link loops, write/truncate data fixes, sandbox .. …
fs_shim 2.7.1: idb link loops, write/truncate data fixes, sandbox .. …
open(mode: FileMode.write) truncates the file (as io); writing nothing over a paged file
updates its size; a truncate then a write in the same page no longer brings back the cut bytes;
many writes of the same bytes before a flush are applied in orderIOSink.done completes once the content is written.. path no longer leaves the sandbox; a name starting with .. is in the
sandboxCo-Authored-By: Claude Opus 5.5 noreply@anthropic.com Claude-Session: https://claude.ai/code/session_012kAtWHb7zEzFysVBwd3m43
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Requires idb_shim 2.11.0.
Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_012kAtWHb7zEzFysVBwd3m43
IdbNativeValue / sdb SdbNativeValue) and
restored without importing src/:
FileSystemOpfsWebFileHandle.fromJsObject() and FileSystemOpfsWebDirectoryHandle.fromJsObject() wrap a
JS handle (any interop binding).handle.jsObject (the wrapped JS handle) and handle.name (also its path in withFileHandles), as
extension getters (FileSystemOpfsWebFileSystemEntityHandleExtension).FileSystemOpfsWeb.queryPermission() and FileSystemOpfsWeb.requestPermission() (mode: read, the
default, or readwrite) return the permission state (granted, denied or prompt).
requestWritePermission() is kept. Browsers without the permission API (Firefox, Safari: OPFS handles
only) return granted (requestWritePermission() used to throw there).idb: openRead(start) past the first page no longer fails with Corrupted content
Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com
dart:io in these cases (bug fixes, the previous behavior lost data or hung):
openRead(start) with a start past the first page (16 KiB pages for getFileSystemWeb() and
newFileSystemWeb()) no longer fails with Corrupted content.File(dirPath).copy()), or a directory onto a directory, fails with an is a
directory status (21) instead of creating an empty file.openRead(start, end) honors end without pages and clamps start and end past the end
of the file (empty stream when start is past the end), an end before start throws a RangeError.writeAsString uses the given encoding.osError is null (instead of a wrapper throwing on access) when dart:io has none.chore: update version to 2.6.0 and dependencies in pubspec.yaml
chore: update version to 2.6.0 and dependencies in pubspec.yaml
InvalidStateError on
every transaction), including from an open RandomAccessFile or write sink; a failed open now reports
its error to the caller and is retried on the next operation; a failed read stream now completes.
Thanks to Samuel Hislop-Lynch (SamHL) for the fix in
#63.Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
Write a Stream<List> to a file, creating the parent directory if missing. On a file system without random access support (OPFS) the stream is buffered
Write a Stream<List> to a file, creating the parent directory if
missing. On a file system without random access support (OPFS) the
stream is buffered in memory and written at once with writeAsBytes,
otherwise it is piped to openWrite.
Bump fs_shim to 2.5.7, add tests to the shared fs_test suite and
document the helper in the fs-shim-filesystem skill.
Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
streamToFile(stream, file) helper and File.writeStream(stream) extension in utils/read_write.dart
to write a Stream<List<int>> to a file, creating the parent directory if missing. On a file system
without random access support (OPFS) the stream is buffered in memory and written at once.Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com Claude-Session: https://claude.ai/code/session_01BeSPt2peAnMDW5fVfk2B6F
Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01BeSPt2peAnMDW5fVfk2B6F
fs-shim-filesystem and fs-shim-platforms agent skills in skills/, installable with dart run skills@ getAdd File.unsandbox() and Directory.unsandbox() extension methods to get the full path in the delegate file system if any
File.unsandbox() and Directory.unsandbox() extension methods to get the full path in the delegate file system
if anydocs: update CHANGELOG to reflect new file system features and condit…
docs: update CHANGELOG to reflect new file system features and condit…
Nothing published for this version
fs_shim 2.5.4+2 update description
fs_shim 2.5.4+2 update description
FileSystemOpfsWeb.withRootHandle() to create a file system rooted at an existing
FileSystemOpfsWebDirectoryHandle (e.g. obtained from
FileSystemOpfsWeb.showDirectoryPicker() or FileSystemOpfsWeb.storageGetDirectory()).FileSystemOpfsWeb.withFileHandles() to create a file system giving access to files obtained from
FileSystemOpfsWeb.showOpenFilePicker()/FileSystemOpfsWeb.showSaveFilePicker().fileSystemOpfsWeb.requestWritePermission() to request the readwrite
permission on a file or directory handlefileSystemDefault so that importing
package:fs_shim/fs.dart no longer pulls dart:io on the web (fixes the build_web_compilers platform check when
compiling web entrypoints)* Add fileSystemOpfsWeb.
fileSystemOpfsWeb.bump version to 2.5.2 and update changelog for dart 3.12 lints
bump version to 2.5.2 and update changelog for dart 3.12 lints
fs_shim v2.5.1 on sdk 3.11
fs_shim v2.5.1 on sdk 3.11
Add Directory.sandbox extension method as shortcut to sandbox a file system
Directory.sandbox extension method as shortcut to sandbox a file systemfsIdbExportLines and fsIdbImport mainly for testing purposeFileStreamSink to add flush feature when writing files.feat: limit sandbox to a single level and update tests for nested san…
feat: limit sandbox to a single level and update tests for nested san…
Nothing published for this version
chore: update version to 2.5.1-2 fix deps
chore: update version to 2.5.1-2 fix deps
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This should be considered as a breaking change, however null was always throwing an error. Sorry if not ok for you...
Directory.tryCreate extension method to create a directory if it does not existFileSystem.sandbox extension method to create a sandboxed file systemFileSystem.unsandbox extension method to get the parent file system directoryFileSystem.absolutePath extension method to get an absolute pathFileSystem.normalizePath extension method to get an absolute pathFileSystem.pathHashCode extension method to get a hash code for a path (normalized and absolute)FileSystem.pathEquals extension method to compare two paths (normalized and absolute)FileSystemEntityParent.link method to create a link in the parent directoryFileSystemEntityParent.childPath method to get a child path in the parent directory/file systempath argument no longer accepted for file, directory, and link constructors and various entity path arguments
in methods (type, isFile, isDirectory, isLink). This should be considered as a breaking change, however null was
always throwing an error. Sorry if not ok for you...Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add FileSystemEntityParent interface with directory(), directoryWith(), and file() methods for Directory and FileSystem
FileSystemEntityParent interface with directory(), directoryWith(), and file() methods for Directory and
FileSystemNothing published for this version
Nothing published for this version
* Requires dart 3.7
Add Directory.emptyOrCreate() helper in utils read_write (fs and io)
Directory.emptyOrCreate() helper in utils read_write (fs and io)Nothing published for this version
Nothing published for this version
Nothing published for this version
Add writeLines/readLines and io lines helpers
Nothing published for this version
Nothing published for this version
* Remove dev_test dependency * Remove dart:html dependency
dev_test dependencydart:html dependencyNothing published for this version
Nothing published for this version
Nothing published for this version
* Dart 3 support
Add fileSystemDefault global on web and io.
fileSystemDefault global on web and io.File, Link and Directory.Directory.current.FileSystemEntity.isLink, FileSystemEntity.isFile, FileSystemEntity.isDirectory,
FileSystemEntity.typeNothing published for this version
Nothing published for this version
* RandomAccessFile support * strict-casts support
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
add toNativePath is utils/path.dart
utils/path.dartNothing published for this version
Nothing published for this version
fix toPosixPath to handle proper conversion of windows drive letter
One column per quarter.