docsifyjs / docsifyjs/docsify-cli

livereload not (reliably) working with devcontainers that share the same uniform port configuration when forwarding ports to host

Open
#253 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
JavaScript
Stars
782
Forks
166
Avg merge
10h 49m
Merged PRs (30d)
1

Description

As a developer who uses devcontainers a lot I have to reuse the same devcontainer features sets as much as possible in order to avoid long devcontainer build times as well as storage explosion -- by sharing a uniform configuration of a single docsify server port instead of two (the second for livereload/hot reloading).

The problem is "a choice between the devil and the deep blue sea":
- either have a uniform docsify port configuration (such as 3300) across all my devcontainer configuration, as mandated by company policy, and have livereloading broken because the devcontainer's livereload port is never the same port number as the forwarded livereload port;
- or configure each and every devcontainer differently in order to use unique ports, which is not only cumbersome and error-prone, but blocked many times by company policies.

Please integrate the livereload port into a single contents+livereload notifications port. Other tools allow this for a long time. Thank you!

Contributor guide

Open the contributing guide

Research direction

No files or tests are named. Trace the docsify CLI entry points that configure the docsify server, forwarded ports, and livereload notifications, then determine how a single shared port can serve both contents and reload events. Done means livereload works reliably when devcontainers forward one uniform port.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, node.js
Domain
cli
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.