Node's Pocket Monsters

    hostr

    3.0.4444 • Public • Published

    hostr

    Join the chat at https://gitter.im/henrytseng/hostr

    Build Status

    Great for testing quick HTML code.

    A simple web server for the current working directory. Used for hello world style web sites hosting only files in current directory structure.

    Serves up files and caches files for quick responses.

    Watches directory structure and refreshes on file changes through LiveReload.

    Installation

    Run the following

    npm install hostr -g
    

    Use

    Run the following command to host the current working directory

    cd project/my_development_project
    hostr
    

    A simple web server will be hosted at

    http://localhost:3000
    

    To host at a different port, set the PORT environment variable (For example, host on port 8080).

    hostr --port 8080

    Watch Changes

    To disable watching (debugging only)

    hostr --watch off

    To ignore files create a .hostrignore file in the current working directory using minimatch notation

    file
    directory/all/files/**/*
    directory/*
    

    For more information check out minimatch

    LiveReload

    LiveReload is used for development. hostr monitors your files. When a file save occurs LiveReload communicates with your site and pushes a refresh to your browser (e.g. - iPhone/Android/Blackberry, Desktop-Chrome/IE/Safari) so that your changes are immediately visible.

    Communication between hostr and LiveReload occur through WebSockets. You must use a WebSocket enabled browser.

    To use LiveReload (additional instructions):

    Add the following code to your HTML:

    <script>document.write('<script src="http://' + (location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1"></' + 'script>')</script>
    

    Then run hostr and when file changes are detected your browser will refresh.

    cd project/my_development_project
    hostr
    

    LiveReload port can be changed (default: 35729), to use port 32021

    hostr --livereload-port 32021

    To disable LiveReload

    hostr --livereload off

    Cache

    To change cache expiration time (seconds, default: 60)

    host --cache-expiration 5

    Quiet Mode

    To run quietly use

    hostr --quiet

    And output will be suppressed

    Contribute

    If you've got ideas on how to make hostr better create an issue and mark an enhancement in Github.

    License

    Copyright (c) 2014 Henry Tseng

    Released under the MIT license. See LICENSE for details.

    Install

    npm i hostr

    DownloadsWeekly Downloads

    151

    Version

    3.0.4444

    License

    MIT

    Unpacked Size

    20.6 kB

    Total Files

    17

    Last publish

    Collaborators

    • henrytseng