LiveDoc
Living Documentation from Executable Specifications
Write tests that double as documentation. LiveDoc turns your BDD features and specifications into browsable, always-up-to-date documentation — powered by the tests you already run.
See the Difference
Most tests verify behavior but document nothing. LiveDoc tests do both:
Typical test — verifies, but tells the reader nothing:
test('discount', () => {
const result = applyDiscount(100, 'SAVE20');
expect(result).toBe(80);
});
LiveDoc spec — verifies and documents:
Scenario: Applying a discount code
Given the cart total is '$100.00'
When the user applies code 'SAVE20'
Then the total becomes '$80.00'
The LiveDoc spec on the right executes as a real test and generates browsable documentation. When the test changes, the docs update automatically. When the test passes, the documentation is accurate.
"Looks Great, But I Don't Have Time to Learn Gherkin"
You don't need to. LiveDoc ships with AI coding skills for both SDKs — when you install the package, your AI assistant already knows how to write LiveDoc tests. Just describe what you want to test:
"Write a spec for the discount logic — 10% off orders over $100, 20% off over $200, free shipping over $150"
Feature: Order Discounts
Scenario: Small order gets no discount
Given a cart with total '$75.00'
When the order is placed
Then the discount is '$0.00'
And shipping is '$9.95'
Scenario: Medium order gets 10% off
Given a cart with total '$120.00'
When the order is placed
Then the discount is '$12.00'
And shipping is '$9.95'
Scenario: Large order gets 20% off and free shipping
Given a cart with total '$250.00'
When the order is placed
Then the discount is '$50.00'
And shipping is '$0.00'
The AI doesn't just produce syntactically correct tests — it produces well-structured living documentation with values in titles, edge cases covered, and clear business language. The built-in skills teach it LiveDoc's patterns, value extraction, and self-documenting conventions.
This works with any AI coding tool — GitHub Copilot, Cursor, Claude Code, and others. The skills are installed alongside the SDK, so there's nothing extra to set up.
Why LiveDoc?
Tests Are the Docs
Your BDD features and specifications generate documentation automatically. When a test changes, the docs update. No more stale wikis.
Always In Sync
Documentation is produced from test results, so it stays aligned with reality. If the test passes, the doc is accurate.
Developer-Friendly
Write tests in the language you already use — TypeScript or C#. No separate .feature files, no extra tooling, no context switching.
Real-Time Feedback
The LiveDoc Viewer shows test results as they run, with a searchable, filterable interface your whole team can use.
How It Works
Describe
Tell your AI assistant what to test — or write specs yourself. The built-in AI skills handle LiveDoc patterns automatically.
Run Tests
Execute with Vitest or xUnit. LiveDoc captures titles, values, steps, and results into a structured reporting model.
Browse Docs
The Viewer renders your test results as browsable, hierarchical specifications — filterable by tags, status, and search.
Choose Your SDK
TypeScript — Vitest
BDD and specification patterns for Vitest with zero boilerplate.
npm install -D @swedevtools/livedoc-vitest
.NET — xUnit
Living documentation for .NET projects via xUnit integration.
dotnet add package SweDevTools.LiveDoc.xUnit