Files, paths and templates.

A small site directory.

The root is /lantern-data/sites/<name>. Page JSON filenames keep their .json extension in links. Only / maps automatically to /index.json. A Lua handler can implement routes such as /greet without a file extension.

1my-first-site/2  index.json       # Home page3  about.json       # /about.json4  guides/5    start.json     # /guides/start.json6  app.lua          # Optional server handler7  data/            # Local ctx.write storage; never upload

How a request is resolved.

1. 1If app.lua exists, load it and call the returned function with ctx.
2. 2If the handler returns a response, use it.
3. 3If it returns nil, try the static JSON file for a GET request.
4. 4If no matching page exists, return a not-found error. Static files do not handle POST.

Pick the right starting point.

Hub package format.

A package is a JSON object with format: 1 and a files map. Map keys are relative paths; values are file contents as strings. The downloadable templates are ready-made packages. The computer’s Upload Hub draft action builds this package for you.

1{2  "format": 1,3  "files": {4    "index.json": "{\"version\":1,\"title\":\"Hello\",\"children\":[{\"type\":\"paragraph\",\"text\":\"Hello!\"}]}"5  }6}

Keep paths inside the site.

Use paths such as /about.json or /guides/start.json. Traversal segments (.. and .), percent escapes, backslashes, query strings, fragments and colon-bearing paths are rejected. Form actions and redirects stay within the current site.