timeline-svg/SCOPE.md
tegwick 4af8a606a1
All checks were successful
CI Smoke / host-smoke (push) Successful in 3s
CI Smoke / container-smoke (push) Successful in 47s
Seeded INTENT.md and stuff
2026-07-08 14:31:33 +02:00

2.9 KiB

SCOPE

This file was generated by statehub register. Refine it as the repository boundaries become clearer.

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

  • {"project_description": "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.", "intent_markdown": null, "domain_slug": "infotech", "topic_slug": "timeline-svg", "topic_title": "TimelineSvg - CSV-to-SVG Timeline Generator", "repo_slug": "timeline-svg", "workplan_prefix": "TMLN-WP", "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": "Actively developed local tool with recent work on a DOM-based prototype template system and inline file editing; test suite and CI smoke workflow (Forgejo) exist; no formal INTENT.md yet."}

Getting Oriented

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