Roadmap: improve documentation, demos, and test coverage
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 25/100
- Issue type
- Documentation
- Clarity
- Needs clarification
- Activity status
- Quiet
- Tech stack
- angular, typescript
- Domain
- documentation, frontend, testing
Research direction
Start by splitting this parent issue into a focused follow-up, beginning with README.md, CONTRIBUTING.md, or the testing strategy document. Read the relevant package areas, including @plait/core, @plait/common, @plait/draw, and @plait/mind, before choosing one task. Done means the selected documentation, demo, or test goal is completed and its stated success criteria are met.
Written by the indexing model from the issue text.
Description
Background
Plait already powers real drawing and whiteboard products, including Drawnix. To make the project feel more professional, trustworthy, and contributor-friendly for the international community, we want to improve three public-facing foundations first:
- Documentation
- Demos and examples
- Test coverage
This issue is the parent tracking issue. We can split the checklist into smaller follow-up issues and complete them one by one.
Goals
- Help new users understand what Plait is, how it relates to Drawnix, and which package to use.
- Help contributors understand the architecture, extension model, and package responsibilities.
- Provide runnable demos that can be used as learning material, not only visual showcases.
- Improve test coverage around public APIs, core transforms, plugin behavior, and important drawing interactions.
- Make project quality easier to evaluate from GitHub and CI.
Documentation TODOs
- Refresh the English
README.mdwith clearer positioning, feature overview, package list, demo links, and development commands. - Explain the relationship between Plait and Drawnix.
- Add or improve
CONTRIBUTING.mdwith local setup, build, test, docs, and PR guidelines. - Add an architecture overview covering board model, element model, plugin pipeline, transforms, rendering, and framework integration.
- Document package responsibilities and dependencies for major packages.
- Improve the custom plugin guide with a complete plugin lifecycle example.
- Improve API docs for board inputs, outputs, options, events, transforms, and public extension points.
- Review existing docs for outdated content, typos, and inconsistent package names.
- Add links from docs pages to related demos and source files.
Demo / Example TODOs
- Add a minimal Angular board example using only the smallest useful Plait setup.
- Add a basic mind map example.
- Add a basic draw example for geometry, arrows, and text.
- Add a flow example with custom nodes and custom edges.
- Add a graph visualization example using the ForceAtlas integration.
- Add a theme customization example.
- Add a custom plugin example that demonstrates element creation, rendering, transforms, and tests.
- Make demo source files easy to find from the documentation.
- Ensure each major package has at least one runnable example.
Test Coverage TODOs
- Define and document the testing strategy for Plait packages.
- Classify tests by type: pure utilities, board transforms, plugin behavior, Angular components, rendering helpers, and interaction logic.
- Add canonical testing examples for each test type.
- Improve
@plait/corecoverage for board creation, selection, viewport, history, group, and z-index behavior. - Improve
@plait/commoncoverage for resize, rotate, line routing, grouping, image helpers, and shared drawing utilities. - Improve
@plait/drawcoverage for geometry creation, arrow-line behavior, table behavior, clipboard behavior, and resize logic. - Improve
@plait/mindcoverage for node transforms, layout behavior, topic positioning, image/emoji behavior, and drag-and-drop detection. - Improve
@plait/layouts,@plait/flow, and@plait/graph-vizcoverage for important edge cases. - Add CI visibility for test coverage, such as coverage artifacts or reports.
- Decide an initial practical coverage baseline, then raise it gradually.
Suggested order
- Refresh the English README.
- Add contribution guidelines.
- Write the testing strategy document.
- Add the first minimal Angular board demo.
- Add the architecture overview.
- Start improving coverage package by package, beginning with
core,common,draw, andmind.
Success criteria
- A new contributor can run the project and understand the package structure within 10 minutes.
- The docs explain both usage and extension, not only internal notes.
- Every major package has a clear documentation entry and at least one runnable example.
- Important public APIs and interaction logic have meaningful tests.
- CI gives maintainers and contributors a clear signal about build and test health.
- Dominant language
- TypeScript
- Stars
- 703
- Forks
- 61
- PR merge metrics
- No merged PRs in 30d
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from worktile/plait
-
Difficulty 1/5 Under an hour Newbie friendliness 88/100
-
area: tooling tracking
Difficulty 4/5 3-5 days Newbie friendliness 35/100
-
area: mind design enhancement
Difficulty 5/5 Over a week Newbie friendliness 35/100
-
area: table design enhancement
Difficulty 5/5 Over a week Newbie friendliness 28/100
-
area: text bug
Difficulty 3/5 1-2 days Newbie friendliness 52/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
milind-soni/OpenMausBot#6730 ·
Maintainers usually reply within 1 day
-
`@angular/[email protected]` depends on vulnerable Vite 7.3.7 - GHSA-p4f5-76q4-ffq7 (Critical RCE)Openarea: @angular/build
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
angular/angular-cli#34764 ·
Maintainers usually reply within 1 day
-
status/need-triage
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
google-gemini/gemini-cli#30384 · 1 comment ·
Maintainers usually reply within 1 day
-
P2
Difficulty 1/5 Under an hour Newbie friendliness 84/100
Maintainers usually reply within 1 day
-
area:image documentation good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Maintainers usually reply within 1 day