Live Reload in WingTip

WingTip includes a development server with automatic rebuild and browser refresh on save. This makes local authoring fast and seamless.

How It Works

• wingtip/serve.py runs a livereload server on port 8000

• It watches these files:

• README.md

• All docs/*.md
• template.html
• main.py

• When a change is detected:

• It runs main.py in a temporary output folder first

• If the build succeeds, it re-runs the actual build
• If the build fails, the current site is preserved
• The browser auto-refreshes via WebSocket connection
• Scroll position is preserved after reload

Run the Dev Server

pip install livereload
python wingtip/serve.py

This will:

• Open http://localhost:8000 in your browser
• Rebuild the site automatically when you save .md or .html files
• Refresh the browser instantly, even retaining scroll

Notes

• Temporary build directory: docs/site_tmp
• Live output directory: docs/site
• Scroll restoration is built-in via the injected livereload client
• Errors during rebuild are logged but do not overwrite the current site

Edit this page on GitHub