SpunkArt
Websites, APIs and search

How to run, host and install a small web tool

Many handy web tools are a single HTML file with some JavaScript inside. You can run one on your own computer, publish it on a static host, or install a web app so it opens like a normal program.

Option 1: open the file directly

Save the .html file anywhere, then double-click it or drag it onto a browser window. The address bar will show a path starting with file:. Tools that only do maths or text processing usually work fine this way.

Before you run any file you downloaded, open it in a text editor and skim it. Look for scripts loaded from unknown domains and for anything that asks you to paste passwords or keys. A single-file tool from an unknown source deserves the same caution as any other program.

Option 2: serve it locally

Browsers restrict some features for pages opened from file:. Loading a separate JSON file, using service workers or some storage features may fail. The fix is a tiny local web server. If Python 3 is installed, open a terminal in the folder and run:

python3 -m http.server 8080

Then visit localhost:8080/tool.html. Press Ctrl+C in the terminal to stop the server. The server listens only while that terminal stays open.

Option 3: publish it on a static host

A static host serves files exactly as they are, with no server code. Many hosting companies and code-hosting platforms offer this. The steps are similar everywhere:

  1. Put the HTML file in a folder. Rename it index.html if it should be the home page.
  2. Create a project on the host and upload the folder, or connect a code repository that holds it.
  3. Wait for the host to give you an address, open it, and test the tool there.
  4. Optionally add your own domain by creating the DNS record the host asks for, then wait for HTTPS to be issued.
ApproachGood forWatch out for
Open the fileQuick personal useBlocked features under file:
Local serverTesting before publishingOnly reachable from your own machine
Static hostSharing with othersAnything in the file becomes public

Option 4: install a web app

A progressive web app (PWA) is a website with a manifest file and usually a service worker, which lets the browser install it like an app. To install one:

  • Desktop Chrome or Edge: look for the install icon at the right end of the address bar, or open the browser menu and choose the install or “apps” option.
  • Android: open the browser menu and choose Install app or Add to Home screen.
  • iPhone and iPad: in Safari, tap the Share button, then Add to Home Screen.

Menu labels change between browser versions, so the wording on your screen may differ slightly. To remove an installed web app, uninstall it the same way you remove any other app.

Common problems

  • Blank page: open DevTools and read the Console for a missing file or blocked script.
  • No install option: the site has no valid manifest, or it is not served over HTTPS.
  • Changes do not show: a service worker is serving a cached copy. Hard-reload or clear site data.

Questions

Do I need an account anywhere to use a single-file tool?

No. Opening it locally needs only a browser. Hosting it publicly needs an account with whichever host you choose.

Is an installed web app safer than a website?

It runs with the same browser permissions as the website. Installing changes how it opens, not what it can access.