Getting Started

Installation

Install with mise, which verifies the release binary’s build provenance attestation by default:

mise use "github:boykush/livt@<version>"

See Installation for all methods and how release artifacts are verified.

Quick Start

1. Create the required directories:

mkdir -p stories discoveries/usm discoveries/example-mappings ubiquitous

2. Create your first story in stories/my-first-story.md:

---
name: My first story
---

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

3. Build and serve:

livt serve

4. Open http://localhost:3000 in your browser. Every page has a sidebar to switch between Example Mappings, Story Maps, Stories, and Ubiquitous Language. Open Stories to find the story you just created:

The site is rendered in English by default. To read it in Japanese instead, add livt.yaml beside your stories/ directory:

lang: ja

livt serve watches the file, so the open page reloads in the new language. Only the labels livt renders change — your stories, rules and terms are shown as you wrote them. See Configuration.