Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

luvi

Package Overview
Dependencies
Maintainers
1
Versions
139
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

luvi

Simple dev server with simple config and API.

  • 0.9.30
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
72
decreased by-5.26%
Maintainers
1
Weekly downloads
 
Created
Source

luvi ♡


$ cd /path/to/your/project
$ luvi
luvi listening on 4444

By default, luvi acts as a static server, serving the files in cwd. On launch, luvi will open a tab in your default browser pointing to your defined root.

Originally forked from freddie.

Why? Because freddie did some things that I really liked, but also did a lot of things that I really don't need, and doesn't do some things that I really do want.

Why 4444? Because I'm OCD, and I really like the number 4.


BREAKING CHANGES

  • 0.8.6: luvi no longer has a proxying utility. If you need that, please use freddie instead.
  • 0.9.13: src/util is now src/lib.
  • 0.9.19: src/ is now project root (src/lib is now /lib)
  • 0.9.20: package.json is fixed so luvi works as a module again. Sorry about that!
  • 0.9.21: Please npm rm -g luvi and then npm i -g luvi to upgrade!

Installation & Usage

$ npm i -g luvi
$ luvi [server, ...] [options]

luvi looks inside cwd for a .luvi.json config file. If there is no config file, the default static server is launched.

[server, ...]
$ luvi foo bar
foo listening on port 4444
bar listening on port 8888

List of named servers to launch. Only names matching the ones in config file will be launched.

[options]

Command-line arguments take priority over config files and defaults.

In a path with a .luvi.json file, running luvi will follow the options in the file, unless any options are passed; if there are multiple servers in the .luvi.json file, every server's options will be overridden. Project root is cwd by default.

$ luvi           # launches the default server
$ luvi foo bar   # starts luvi servers `foo` & `bar`
$ luvi -p 1337   # serves from specified port (for < 1024, must be root)
$ luvi -r /path  # serves from the specified directory
$ luvi -v        # display's luvi's version
$ luvi -h        # shows a version of this help dialog

.luvi.json

To configure a single server: {"root":"public","port":9090}. The object will be passed directly to luvi.

For multiple servers, simply use an array of single-server configs. Use the name option to keep track of servers in logs.

[{
  "name": "drafts",
  "root": "src",
  "port": 1337
},{
  "name": "testing",
  "root": "build"
},{
  "name": "todo",
  "root": "doc",
  "port": 6565,
  "notFound": "/var/www/404.html"
}]

API

You can pass an object to luvi() for custom settings; otherwise, these defaults are applied:

const luvi = require('luvi')
luvi({
    name : 'luvi'
  , root : process.cwd()
  , port : 4444
})

This is exactly the same as just calling luvi(), with no config object.

These defaults are merged with whatever you pass, so if, for example, you only pass in a custom server name, luvi will still run on port 4444 and use cwd as the root to serve.

Multiple servers can be launched from the same script, with different configs, by calling luvi() again with different options.

options
  • root
    • root: '/path/to/document/root'
    • Str Path where your static files are placed. Server only allows access to files in this directory. Usually where you'd have index.html. Can be absolute or relative.
    • Default : process.cwd()
  • port
    • port: 3000
    • Int Port on which to listen. If specified port is busy, luvi will look for a free port.
    • Default : 4444.
  • name
    • name: 'foo'
    • Str Server name. Useful for launching multiple servers, and for keeping track in logs.
    • Default : luvi.
  • onListen
    • onListen: function(name, port){console.log(name, 'is listening on', port)}
    • function(name,port) Called when luvi starts listening.
    • Default : console.log() (as above).
  • notFound
    • notFound: '/path/to/404.html'
    • Str Path to a custom 404 page.
    • Default : undefined.

Contributing

Please do, if you'd like! The one thing I'd really like to get going is live reloading, but any issue reports/fixes are welcome, and feature requests can definitely be discussed.

License: WTFPL

Keywords

FAQs

Package last updated on 03 Sep 2016

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc