livt

Collaborate on board. Make it living in text.

Documentation | Getting Started | Guides | Commands

What is livt?

livt is a CLI tool that captures collaborative discovery outcomes as living text. It bridges the gap between synchronous discovery sessions (like User Story Mapping and Example Mapping) and development artifacts.

Discovery outcomes are written as plain text files (YAML, Markdown) and visualized as boards:

Features

• Stories as Markdown -- Write stories with YAML frontmatter, keep them alongside your code
• Story Maps -- Visualize activities, steps, and stories with release slices on a board
• Example Mappings -- Render rules, examples, and questions as color-coded sticky notes
• Static HTML output -- livt build generates a standalone site, no runtime required
• Local dev server -- livt serve builds and serves with one command

Installation

go install github.com/boykush/livt@latest

Quick Start

# Create the directory structure
mkdir -p stories discoveries/usm discoveries/example-mappings

# Create your first story
cat <<'EOF' > stories/my-first-story.md
---
name: My first story
---

As a user
I want to do something
So that I get value
EOF

# Build and serve
livt serve

Open http://localhost:3000 in your browser.

See the Getting Started guide for more details.

File Structure

stories/
  {story-key}.md                     # Story files
discoveries/
  usm/
    {map-name}.yaml                  # Story map files
  example-mappings/
    {story-key}.yaml                 # Example mapping files

See File Structure reference for output details.

License

MIT