# bare-fs

> Native file system operations for Bare

Latest version **4.8.1** (published 2026-08-24) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install bare-fs
pnpm add bare-fs
yarn add bare-fs
bun add bare-fs
```

## Health

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

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

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 4.8.1 |
| Published | 2026-08-24 |
| First published | 2023-05-16 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 5 |
| Unpacked size | 1.3 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 27 |
| Author | Holepunch |
| Maintainers | mafintosh |

## Links

- npm: https://www.npmjs.com/package/bare-fs
- Repository: https://github.com/holepunchto/bare-fs
- Homepage: https://github.com/holepunchto/bare-fs#readme
- Issues: https://github.com/holepunchto/bare-fs/issues
- npm.io page: https://npm.io/package/bare-fs

## Dependencies (5)

- [bare-url](https://npm.io/package/bare-url.md) ^2.2.2
- [bare-path](https://npm.io/package/bare-path.md) ^3.0.0
- [fast-fifo](https://npm.io/package/fast-fifo.md) ^1.3.2
- [bare-events](https://npm.io/package/bare-events.md) ^2.5.4
- [bare-stream](https://npm.io/package/bare-stream.md) ^2.6.4

## Recent versions

- 4.8.1 (latest) — 2026-08-24
- 4.8.0 — 2026-08-03
- 4.7.4 — 2026-07-07
- 4.7.3 — 2026-07-02
- 4.7.2 — 2026-06-02
- 4.7.1 — 2026-04-15
- 4.7.0 — 2026-04-09
- 4.6.0 — 2026-04-02
- 4.5.6 — 2026-03-19
- 4.5.5 — 2026-02-25
- 4.5.4 — 2026-02-12
- 4.5.3 — 2026-01-26
- 4.5.2 — 2025-11-27
- 4.5.1 — 2025-11-10
- 4.5.0 — 2025-10-22
- … 76 more at https://npm.io/package/bare-fs/versions

## README

# bare-fs

Native file system operations for Bare. The API closely follows that of the Node.js `fs` module.

```
npm i bare-fs
```

## Usage

```js
const fs = require('bare-fs')

const fd = await fs.open('hello.txt')

const buffer = Buffer.alloc(1024)

try {
  const length = await fs.read(fd, buffer)

  console.log('Read', length, 'bytes')
} finally {
  await fs.close(fd)
}
```

## API

See the [`bare-fs` reference](https://docs.pears.com/reference/bare/modules/bare-fs).

## License

Apache-2.0

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