https://github.com/stopsopa/npx-server

🤖No dependency, single script http server with custom controllers (for various debugging purposes)
https://github.com/stopsopa/npx-server

Last synced: 22 days ago
JSON representation

🤖No dependency, single script http server with custom controllers (for various debugging purposes)

• Host: GitHub
• URL: https://github.com/stopsopa/npx-server
• Owner: stopsopa
• License: mit
• Created: 2018-11-20T13:59:32.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-09-14T09:53:08.000Z (about 1 year ago)
• Last Synced: 2024-10-17T15:39:55.517Z (29 days ago)
• Language: JavaScript
• Homepage: https://stopsopa.github.io/npx-server/
• Size: 144 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![npm version](https://badge.fury.io/js/npx-server.svg)](https://badge.fury.io/js/npx-server)

[![NpmLicense](https://img.shields.io/npm/l/npx-server.svg)](https://github.com/stopsopa/npx-server/blob/master/LICENSE)

Created in 2018 - quite old now and not maintained

What's that?

It's just simple HTTP server with 

- autoindexing of directories

- custom (one file) controllers system which logic is reloading without reloading server. 

- reloading browser (hotloader) if one of files on the hard drive changed

- everything shipped in one .js file with no dependencies. 

- one command installation

Techniques:

It was written just in plain js without any bundlers to just serve files, but later it was extended gradually with more and more features.

It supposed to be just dirty tool to do the job from one file, for some testing.

What I'm trying to say is: It's ugly and I never had intention to make it pretty. But it was still fun to build it at some point.

[![npx-server youtube demo](https://user-images.githubusercontent.com/3743506/48829880-40d84900-ed6b-11e8-8a9b-ff566f15d2a9.png)](http://www.youtube.com/watch?v=uAO9Buimxys)

    npx npx-server@latest

    

    or

    

    npx npx-server server.js

    

    or

    

    npx npx-server [server_file_name.js] [controllers_directory]

    

    

    

    

# Warning

Server have no XSS protection and might have other security issues. In wrong hands, badly managed it might present security thread.

Script is mostly created for local development/testing purposes with main goal to quickly bring it where it is needed and launch without dependencies. 

I wouldn't recommend it to use on production.

# Notes

Simple equivalent in python would be: 

```bash

python -m http.server 8000

# or

python -m SimpleHTTPServer 8000

```

...from https://docs.docker.com/desktop/mac/networking/