# @stacksjs/storage

> The Stacks file system.

Latest version **0.74.46** (published 2026-09-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install @stacksjs/storage
pnpm add @stacksjs/storage
yarn add @stacksjs/storage
bun add @stacksjs/storage
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.74.46 |
| Published | 2026-09-11 |
| First published | 2022-11-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 11 |
| Unpacked size | 190.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 628 |
| Author | Chris Breuer |
| Maintainers | chrisbreuer, glenn123 |
| Keywords | storage, fs, file system, glob, api, collections, utilities, functions, bun, stacks |

## Links

- npm: https://www.npmjs.com/package/@stacksjs/storage
- Repository: https://github.com/stacksjs/stacks
- Homepage: https://github.com/stacksjs/stacks/tree/main/storage/framework/core/storage#readme
- Issues: https://github.com/stacksjs/stacks/issues
- Funding: https://github.com/sponsors/chrisbbreuer
- npm.io page: https://npm.io/package/@stacksjs/storage

## Dependencies (11)

- [ts-images](https://npm.io/package/ts-images.md) ^0.2.11
- [@stacksjs/cli](https://npm.io/package/@stacksjs/cli.md) 0.74.46
- [@stacksjs/env](https://npm.io/package/@stacksjs/env.md) 0.74.46
- [@stacksjs/path](https://npm.io/package/@stacksjs/path.md) 0.74.46
- [@stacksjs/arrays](https://npm.io/package/@stacksjs/arrays.md) 0.74.46
- [@stacksjs/config](https://npm.io/package/@stacksjs/config.md) 0.74.46
- [@stacksjs/ts-xml](https://npm.io/package/@stacksjs/ts-xml.md) ^0.1.0
- [@stacksjs/logging](https://npm.io/package/@stacksjs/logging.md) 0.74.46
- [@stacksjs/strings](https://npm.io/package/@stacksjs/strings.md) 0.74.46
- [@stacksjs/ts-cloud](https://npm.io/package/@stacksjs/ts-cloud.md) ^0.16.0
- [@stacksjs/error-handling](https://npm.io/package/@stacksjs/error-handling.md) 0.74.46

## Alternatives

- [unionfs](https://npm.io/package/unionfs.md) — 2.2M weekly downloads
- [path-starts-with](https://npm.io/package/path-starts-with.md) — 35.9K weekly downloads
- [redzip](https://npm.io/package/redzip.md) — 1.2K weekly downloads
- [vscode-anymatch](https://npm.io/package/vscode-anymatch.md) — 848 weekly downloads
- [@ledgerhq/coin-filecoin](https://npm.io/package/@ledgerhq/coin-filecoin.md) — 793 weekly downloads

## Recent versions

- 0.74.46 (latest) — 2026-09-11
- 0.74.45 — 2026-09-11
- 0.74.43 — 2026-09-11
- 0.74.42 — 2026-09-10
- 0.74.41 — 2026-09-10
- 0.74.40 — 2026-09-10
- 0.74.39 — 2026-09-10
- 0.74.38 — 2026-09-10
- 0.74.37 — 2026-09-10
- 0.74.36 — 2026-09-10
- 0.74.35 — 2026-09-10
- 0.74.34 — 2026-09-10
- 0.74.33 — 2026-09-09
- 0.74.32 — 2026-09-09
- 0.74.31 — 2026-09-08
- … 628 more at https://npm.io/package/@stacksjs/storage/versions

## README

# Stacks Storage

This package contains the Stacks File System source.

## ☘️ Features

- Easily create your own cloud storage
- Driver-based architecture
- Local, S3, and memory drivers
- Laravel-like Storage API

### TODO

- [ ] Add Google Cloud Storage driver
- [ ] Add Azure Blob Storage driver

## 🤖 Usage

```bash
bun install -d @stacksjs/storage
```

Now, you can use it in your project:

```js
import {
  _dirname,
  copyFolder,
  deleteEmptyFolders,
  deleteFiles,
  deleteFolder,
  doesFolderExist,
  fileURLToPath,
  hasComponents,
  hasFiles,
  hasFunctions,
  isFile,
  isFolder,
  readJsonFile,
  readTextFile,
  writeJsonFile,
  writeTextFile,
} from '@stacksjs/storage'

// wip
```

To view the full documentation, please visit [<https://stacksjs.com/storag>e](https://stacksjs.com/storage).

## 🧪 Testing

```bash
bun test
```

## 📈 Changelog

Please see our [releases](https://github.com/stacksjs/stacks/releases) page for more information on what has changed recently.

## 🚜 Contributing

Please review the [Contributing Guide](https://github.com/stacksjs/contributing) for details.

## 🏝 Community

For help, discussion about best practices, or any other conversation that would benefit from being searchable:

[Discussions on GitHub](https://github.com/stacksjs/stacks/discussions)

For casual chit-chat with others using this package:

[Join the Stacks Discord Server](https://stacksjs.com/discord)

## 📄 License

The MIT License (MIT). Please see [LICENSE](https://github.com/stacksjs/stacks/tree/main/LICENSE.md) for more information.

Made with 💙

---
_Source: https://npm.io/package/@stacksjs/storage · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._