pkgs.ml
Activity Stats For agents Log in with GitHub

minttea

v0.0.43

Elm-style terminal UI framework

Repository Open docs Open in playground
Install
riot add minttea
riot.toml
minttea = "0.0.43"
Last release
May 15, 2026
License
Apache-2.0
Dependencies
4
Dependents
0
Installs
3
Published versions
33
Owner
@leostera@leostera
Examples (12)
001_hello_world 002_spinner 003_progress 004_clock 005_list_simple 006_tabs 007_textinput 008_table 009_viewport 010_textarea 011_paginator 012_fps
README Expand

minttea

Elm-style terminal UI programming for Riot.

minttea is the package to reach for when you want to build interactive TUIs around a model -> update -> view loop. It sits on top of gooey and tty and gives you a clean, explicit application structure instead of making you mix event handling, terminal state, and rendering by hand.

Install

riot add minttea

Mental model

Every app is defined in three pieces:

  • init to set up the initial model and first command;
  • update to react to keyboard, mouse, timer, and custom events;
  • view to render the current model into Gooey.Element values.

That keeps side effects explicit and makes terminal apps feel much more like small state machines than a pile of callbacks.

Example

open Std
open Minttea

type model = string

let init = fun model -> (model, Command.Noop)

let update = fun event model ->
  match event with
  | Event.KeyDown (Event.Key "q", _)
  | Event.KeyDown (Event.Escape, _) -> (model, Command.Quit)
  | _ -> (model, Command.Noop)

let view = fun model -> Element.text model

let app = App.make ~init ~update ~view ()

let () = Minttea.start app "Hello, World!"

The package already ships a good examples gallery:

riot run -p minttea 001_hello_world
riot run -p minttea 004_clock
riot run -p minttea 008_table

Press q in those demos to quit.

What minttea includes

  • Minttea.App for constructing apps;
  • Minttea.Event for keyboard, mouse, timer, resize, paste, and focus events;
  • Minttea.Command for quit/cursor/screen/timer and terminal-control effects;
  • Minttea.Element and Minttea.Style, re-exported from gooey;
  • Minttea.Component for reusable UI building blocks.

Related packages

  • gooey provides the terminal layout and styling primitives.
  • tty handles lower-level terminal mechanics.
Installs
Downloads over the last 30 days, stacked by release.
Total installs
3
Downloads over the last 30 days
v0.0.431
v0.0.420
v0.0.410
v0.0.400
v0.0.390
Package status
Submission, indexing, and post-publish processing milestones for this release.
Submitted
May 15, 08:09 PM
Indexed
May 15, 08:09 PM
Searchable
May 15, 08:09 PM
Docs ready
May 15, 08:25 PM
Completed
Pending
Dependencies
Dependencies declared for this release.
Show 4 dependencies Expand
Dependents
Packages that currently depend on minttea.
No dependents Expand

No indexed dependents yet.

Recent activity
Latest publication, indexing, and post-publish pipeline events recorded for this package.
Open full activity
Show 12 recent events Expand
  • Blocked
    minttea 0.0.43 attempt 3 · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:43:09 PM
    Event
    Blocked
    Package
    minttea
    Version
    0.0.43
    Facts
    attempt 3 artifact 169397bf6c10
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "status": "blocked",
  "attempt_count": 3,
  "error": "error: Unknown argument: minttea"
}
  • Build failed
    minttea 0.0.43 build · exit 1 · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:43:07 PM
    Event
    Build failed
    Package
    minttea
    Version
    0.0.43
    Summary
    error: Unknown argument: minttea
    Facts
    build exit 1 artifact 169397bf6c10
    Artifacts
    Result key
    pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/result.json
    Logs key
    pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/build.log
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "run_kind": "build",
  "result_key": "pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/result.json",
  "logs_key": "pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 121,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: minttea",
  "stdout_excerpt": "error: Unknown argument: minttea"
}
  • Processing
    minttea 0.0.43 attempt 3 · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:43:01 PM
    Event
    Processing
    Package
    minttea
    Version
    0.0.43
    Facts
    attempt 3 artifact 169397bf6c10
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "status": "processing",
  "attempt_count": 3
}
  • Requeued
    minttea 0.0.43 attempt 2 · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:37:28 PM
    Event
    Requeued
    Package
    minttea
    Version
    0.0.43
    Facts
    attempt 2 artifact 169397bf6c10
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "status": "pending",
  "attempt_count": 2,
  "next_attempt_at": "2026-05-15T20:42:28.075Z",
  "error": "error: Unknown argument: minttea"
}
  • Build failed
    minttea 0.0.43 build · exit 1 · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:37:26 PM
    Event
    Build failed
    Package
    minttea
    Version
    0.0.43
    Summary
    error: Unknown argument: minttea
    Facts
    build exit 1 artifact 169397bf6c10
    Artifacts
    Result key
    pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/result.json
    Logs key
    pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/build.log
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "run_kind": "build",
  "result_key": "pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/result.json",
  "logs_key": "pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 48,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: minttea",
  "stdout_excerpt": "error: Unknown argument: minttea"
}
  • Processing
    minttea 0.0.43 attempt 2 · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:37:21 PM
    Event
    Processing
    Package
    minttea
    Version
    0.0.43
    Facts
    attempt 2 artifact 169397bf6c10
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "status": "processing",
  "attempt_count": 2
}
  • Requeued
    minttea 0.0.43 attempt 1 · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:25:54 PM
    Event
    Requeued
    Package
    minttea
    Version
    0.0.43
    Facts
    attempt 1 artifact 169397bf6c10
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "status": "pending",
  "attempt_count": 1,
  "next_attempt_at": "2026-05-15T20:30:54.045Z",
  "error": "error: Unknown argument: minttea"
}
  • Docs ready
    minttea 0.0.43 docs · 2 json · doc.package_generation_completed · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:25:27 PM
    Event
    Docs ready
    Package
    minttea
    Version
    0.0.43
    Facts
    docs 2 json doc.package_generation_completed artifact 169397bf6c10
    Artifacts
    Result key
    pipelines/docs/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/result.json
    Logs key
    pipelines/docs/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/command.log
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "run_kind": "docs",
  "output_prefix": "docs/minttea/0.0.43/",
  "public_docs_url": "https://docs.pkgs.ml/p/minttea/0.0.43/",
  "result_key": "pipelines/docs/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/result.json",
  "logs_key": "pipelines/docs/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/command.log",
  "json_event_count": 2,
  "non_json_stdout_count": 0,
  "last_json_event_type": "doc.package_generation_completed"
}
  • Build failed
    minttea 0.0.43 build · exit 1 · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:25:25 PM
    Event
    Build failed
    Package
    minttea
    Version
    0.0.43
    Summary
    error: Unknown argument: minttea
    Facts
    build exit 1 artifact 169397bf6c10
    Artifacts
    Result key
    pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/result.json
    Logs key
    pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/build.log
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "run_kind": "build",
  "result_key": "pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/result.json",
  "logs_key": "pipelines/builds/minttea/0.0.43/169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 58,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: minttea",
  "stdout_excerpt": "error: Unknown argument: minttea"
}
  • Processing
    minttea 0.0.43 attempt 1 · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:25:13 PM
    Event
    Processing
    Package
    minttea
    Version
    0.0.43
    Facts
    attempt 1 artifact 169397bf6c10
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "status": "processing",
  "attempt_count": 1
}
  • Queued
    minttea 0.0.43 artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:09:38 PM
    Event
    Queued
    Package
    minttea
    Version
    0.0.43
    Facts
    artifact 169397bf6c10
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "status": "pending"
}
  • Indexed
    minttea 0.0.43 latest 0.0.43 · artifact 169397bf6c10
    Details
    When
    May 15, 2026, 08:09:34 PM
    Event
    Indexed
    Package
    minttea
    Version
    0.0.43
    Facts
    latest 0.0.43 artifact 169397bf6c10
    Payload
    {
  "artifact_sha256": "169397bf6c109510a6beaa972602179e2c73ac9296ec27d3b4251d335df699c1",
  "latest": "0.0.43",
  "package_index_key": "index/v1/mi/nt/minttea.json",
  "package_index_url": "https://cdn.pkgs.ml/index/v1/mi/nt/minttea.json",
  "changed": true
}