SCOPE

Lightweight boundary for agents and contributors.

One-liner

TimelineSvg is a client-side, browser-based tool that generates multi-lane SVG timeline graphics from CSV data using an Inkscape-editable SVG template system with no backend or build pipeline.

Core Idea

timeline-svg exists to provide the capability described in INTENT.md.

In Scope

Parsing CSV data into timeline items with configurable field mappings
Rendering multi-lane SVG timelines via a template-v2 (DOM-based) architecture
Supporting Inkscape/Illustrator/Figma-editable SVG templates with placeholder substitution
Providing a browser UI (index.html/engine.js) for loading projects, previewing, and exporting SVGs
In-browser inline file editing with modification tracking
Vitest-based test suite covering generator, engine, and integration flows
Distribution packaging (make dist/dist-zip) for offline/Windows deployment

Out of Scope

Server-side or backend processing (fully client-side by design)
Build pipeline or bundler-based tooling
Non-timeline visualization types (e.g., Gantt-specific scheduling logic beyond basic lanes/items)
Authentication, multi-user collaboration, or persistence beyond local files

Current State

Template-v2 refactoring complete (40+ Vitest tests); Forgejo CI smoke workflow active.
Bootstrap State Hub integration (TMLN-WP-0001) finished; next: distribution packaging (TMLN-WP-0002).

Getting Oriented

Start with: INTENT.md
Agent instructions: AGENTS.md
Workplans: workplans/

1.5 KiB Raw Permalink Blame History