Skip to content

debanshup/quickserve

Repository files navigation

QuickServe

Logo

Installs Rating GitHub issues GitHub license

QuickServe is a zero-config local development server for VSCode. Open a workspace, start the server, and instantly preview your HTML and Markdown files — no setup, no config, no friction.


Demo

Demo


Features

  • One-click server — start and stop directly from the VSCode status bar
  • Open with QuickServe — right-click any .html or .md file to open it instantly in the browser
  • Live preview — instant browser preview for .html and .md files
  • Auto-reload — browser reloads automatically on file save (.html and .md only)
  • HMR — hot module replacement for faster, state-preserving updates
  • Deep dependency graph — tracks file relationships for accurate change detection
  • Self-healing HTTPS — zero-config HTTPS that automatically recovers broken configurations (requires mkcert installed)
  • QR code for mobile — scan to open your local server on any device on the same network
  • File exclusions — exclude specific files from change detection
  • Customizable port — configure the server port to fit your setup
  • Broad file support — serves any file type, not just HTML and Markdown

Installation

  1. Open VSCode
  2. Press Ctrl+P (or Cmd+P on Mac) and run:
ext install debanshupanigrahi.quickserve

Tip: You can also search QuickServe directly in the Extensions sidebar (Ctrl+Shift+X).


How to Use

1. Start the server

Click the QuickServe button in the status bar, or use the command palette (Ctrl+Shift+P) and run quickserve.run.

Start server

2. Open the output panel

To see server logs and the local URL, open the Output panel and select QuickServe from the drop down.

Output panel

3. Access on mobile

Scan the QR code shown in the output panel to instantly open the server on any mobile device connected to the same network.

Access

4. Stop the server

Click the QuickServe button in the status bar, or use the command palette (Ctrl+Shift+P) and run quickserve.kill.

Stop server


Configuration

For all available settings and configuration options, see SETTINGS.md.


Known Limitations

  • Multi-root workspaces — QuickServe currently serves the primary (first) folder in your workspace. Full multi-root support is planned for a future release.
  • Auto-reload scope — live reload and HMR are only available for .html and .md files. Other file types are served statically.

Changelog

For a full list of changes across versions, see CHANGELOG.md.


Contributing

Contributions are welcome! See CONTRIBUTING.md to get started.


License

This project is licensed under the MIT license.

About

The ultimate zero-config dev server. Features Hot Module Replacement, automatic HTTPS certificates, and QR code for mobile testing.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors