Write the lexicon. HappyView serves the API.

$ hpy happyview dev

$ curl 'http://127.0.0.1:3000/xrpc/com.example.hello?name=Ada'
{"message":"Hello, Ada!"}

src/lexicons/com/example/hello.json

{
  "lexicon": 1,
  "id": "com.example.hello",
  "defs": {
    "main": {
      "type": "query",
      "description": "Says hello. The file's path is its route: rename the file and this id together.",
      "parameters": {
        "type": "params",
        "properties": {
          "name": { "type": "string", "maxLength": 64 }
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "type": "object",
          "required": ["message"],
          "properties": {
            "message": { "type": "string" }
          }
        }
      }
    }
  }
}

src/lexicons/com/example/hello.lua

-- Answers com.example.hello. Save this file and the next request runs it.
function handle(input, ctx)
  return { message = "Hello, " .. (input.name or "world") .. "!" }
end

happyview.toml

# A HappyView project. `hpy happyview dev` runs it; happyview.lock pins
# the exact plugin versions, and `hpy happyview add` edits both files.

[happyview]
version = "3.0.0-alpha.42"

[instance]
app_name = "statusboard"
superadmin = "did:plc:your-did-here"

[interpreters]
lua = { did = "did:plc:mo7vq4jbioxwafy5zkcc3eux", name = "happyview-lua", channel = "alpha" }

[libraries]

[dev]
backfill = false