https://github.com/fvsch/servitsy
Small, local HTTP server for static files
https://github.com/fvsch/servitsy
Last synced: 3 months ago
JSON representation
Small, local HTTP server for static files
- Host: GitHub
- URL: https://github.com/fvsch/servitsy
- Owner: fvsch
- License: mit
- Created: 2024-06-30T10:47:24.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-17T13:52:15.000Z (4 months ago)
- Last Synced: 2025-04-14T01:12:36.332Z (3 months ago)
- Language: TypeScript
- Homepage:
- Size: 358 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# servitsy
Small, local HTTP server for static files.
- **Small:** no dependencies, 22 kilobytes gzipped.
- **Local:** designed for local development workflows.
- **Static:** serves files and directory listings.
## Usage
```sh
npx servitsy [directory] [options]
```
> [!NOTE]
> servitsy is a command-line tool, published as a npm package. It requires [Node.js] version 18 or higher, or a compatible runtime like [Deno] or [Bun].
```sh
# Running with Bun
bunx servitsy
# Running with Deno (will prompt for read access)
deno run --allow-net --allow-sys npm:servitsy
```
Calling servitsy without options will:
- serve the current directory at `http://localhost:8080` (listening on hostname `0.0.0.0`);
- try the next port numbers if `8080` is not available;
- serve `index.html` files for folders, and `.html` files when the extension was omitted in the URL;
- serve directory listings (for folders without an index file).
## Options
You can configure servitsy's behavior [with options](https://github.com/fvsch/servitsy/blob/main/doc/options.md). For example:
```sh
# Serve current folder on port 3000, with CORS headers
npx servitsy -p 3000 --cors
# Serve 'dist' folder and disable directory listings
npx servitsy dist --no-list
```
- Use `npx servitsy --help` for an overview of available options.
- Read [doc/options.md](https://github.com/fvsch/servitsy/blob/main/doc/options.md) for details and examples.
## Changelog
See [doc/changelog.md](https://github.com/fvsch/servitsy/blob/main/doc/changelog.md) for the release history.
## License
This package is licensed under [the MIT license](./LICENSE).
## Alternatives
> [!WARNING]
> **servitsy is not designed for production.** There are safer and faster tools to serve a folder of static HTML to the public. See Apache, Nginx, `@fastify/static`, etc.
For local testing, here are a few established alternatives you may prefer, with their respective size:
| Package | Version | Dependencies | Installed size† |
| ------------- | ------- | ------------ | --------------- |
| [servitsy] | 0.5.0 | 0 | 104 kB |
| [servor] | 4.0.2 | 0 | 144 kB |
| [sirv-cli] | 3.0.0 | 12 | 396 kB |
| [serve] | 14.2.4 | 87 | 7.5 MB |
| [http-server] | 14.1.1 | 52 | 9.4 MB |
If size and dependency count is not a concern and you want something stable and battle-tested, I recommend [serve] and [http-server].
Otherwise [servitsy], [sirv-cli] or [servor] might work for you.
_† Installed size is the uncompressed size of the package and its dependencies (as reported by `du` on macOS; exact size may depend on the OS and/or filesystem)._
[Bun]: https://bun.sh/
[Deno]: https://deno.com/
[Node.js]: https://nodejs.org/
[http-server]: https://www.npmjs.com/package/http-server
[serve]: https://www.npmjs.com/package/serve
[servitsy]: https://www.npmjs.com/package/servitsy
[servor]: https://www.npmjs.com/package/servor
[sirv-cli]: https://www.npmjs.com/package/sirv-cli