sørvør
fast, zero config server for single page applications.
đŞ Powered By
- esbuild - an extremely fast JavaScript bundler
- golang - an expressive, concise, clean, and efficient programming language.
⨠Features
- SPA Routing - redirects path requests to
src/index.html for frontend routing
- Asset Pipeline - strong asset processing with simple premitives
- HTML entry point - use
src/index.html as an entry point for an application
⥠Installation
Use gobinaries to install sørvør:
curl -sf https://gobinaries.com/osdevisnot/sorvor/cmd/sorvor | sh
Alternatively, if you have go installed, use go get to install sørvør:
go get github.com/osdevisnot/sorvor
đ˝ Usage
You can use sørvør as a local development server or as a build tool. By default, the sørvør command will build your project and exit. To start a local development server, pass --dev as a command line argument.
sorvor --dev
đ Asset Pipeline
sørvør provides strong asset pipeline with simple premitives.
Currently, only esbuild assets are supported.
For Example: configure index.html to use esbuild bundling for index.js
<script type="module" src="{{ esbuild "index.js" }}"></script>
đ˘ Configuration
For most part, sørvør tries to use sensible defaults, but you can configure the behaviour using command line arguments below:
| cli argument |
description |
default value |
--src=... |
source directory for sørvør |
src |
--port=... |
port for sørvør |
1234 |
--dev |
enable development mode |
false |
sørvør forwards all the other command line arguments to esbuild. Please refer documentation for simple esbuild options or advance options to further customize your builds.
For example, to use esbuild with modern esm format, use a command like this:
sorvor --format=esm --dev
sørvør configures below values for esbuild as defaults:
| cli argument |
description |
default value |
--bundle |
enables bundling output files |
true |
--write |
enables writing built output to disk |
true |
--port=... |
port to start esbuild in serve mode |
1234 (if --dev mode is enabled) |
--outdir=... |
target directory for esbuild output |
dist |
đĽ License
sørvør is licensed under the MIT License.
Documentation is licensed under Creative Commons License.
Created with â¤ď¸ by @osdevisnot and all contributors.