{"id":15002315,"url":"https://github.com/lichendust/toil","last_synced_at":"2026-03-27T02:08:44.021Z","repository":{"id":222022874,"uuid":"707301427","full_name":"lichendust/toil","owner":"lichendust","description":"🗜️ A no-nonsense hot-loading static file server","archived":false,"fork":false,"pushed_at":"2025-08-21T00:06:39.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-13T18:51:58.857Z","etag":null,"topics":["jamstack","server","static-site","web","webdev"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lichendust.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-19T16:04:22.000Z","updated_at":"2025-08-21T00:06:38.000Z","dependencies_parsed_at":"2024-06-19T15:00:26.988Z","dependency_job_id":"8d487a2a-43a0-4603-972b-2bddd039ddf5","html_url":"https://github.com/lichendust/toil","commit_stats":null,"previous_names":["qxoko/toil","lichendust/toil"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/lichendust/toil","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lichendust%2Ftoil","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lichendust%2Ftoil/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lichendust%2Ftoil/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lichendust%2Ftoil/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lichendust","download_url":"https://codeload.github.com/lichendust/toil/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lichendust%2Ftoil/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31009223,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-27T01:56:05.093Z","status":"online","status_checked_at":"2026-03-27T02:00:08.055Z","response_time":164,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jamstack","server","static-site","web","webdev"],"created_at":"2024-09-24T18:49:33.148Z","updated_at":"2026-03-27T02:08:43.988Z","avatar_url":"https://github.com/lichendust.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🗜️ Toil\n\nA simple, no-nonsense, hot-reloading web server for local static site development.\n\nToil is something I built in a day to solve this problem for myself.  It's never going to be much cleverer than it already is.  You may use it at your own risk.\n\n## What does it do?\n\nIt supports regular old static file structures —\n\n\tlocalhost:3456/page/index.html\n\n...but also pretty URLs —\n\n\tlocalhost:3456/page\n\nIf those files change on disk, it will hot-reload them. It polls once every second so as not to unduly waste resources.\n\nWith appropriate firewall permissions, it can serve as many clients as you like (within reason).\n\n## Installation\n\nWith the Go compiler —\n\n\tgo install github.com/lichendust/toil@latest\n\n## Usage\n\n\ttoil\n\nWill immediately begin serving and hot-loading the working directory.  It will also, on startup, open your default browser to the `index.html` page it finds there.\n\n\ttoil path/to/files\n\nYou can optionally pass a path, to serve a specific folder.  Toil just changes directories internally and starts normally.\n\nUse Ctrl+C to close it.\n\nUse the `-r` flag to specific a domain to replace with local paths.\n\n\ttoil -r https://lichendust.com path/to/files\n\nThis will strip out the exact string from any pages Toil serves, a simple way to make links relative in locally served pages that otherwise contain fully qualified URLs.  Useful for SSGs that don't have their own servers.\n\n## Important Info\n\nToil expects properly formatted HTML files with at least a `\u003chead\u003e` and `\u003cbody\u003e`.  It will insert its client-side hot-reload listener into the `\u003chead\u003e`.  There must *be a head already for this to work*.  Toil is not a smart server and will not solve any incompletely-formatted HTML documents for you.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flichendust%2Ftoil","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flichendust%2Ftoil","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flichendust%2Ftoil/lists"}