Skip to content

About

A workflow matrix builder.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

FlowMatrix

FlowMatrix is a static, browser-based editor for cross-department workflows. It stores one project in a portable JSON file and offers an adaptive phase-by-department matrix plus a detailed activity flow editor.

Develop and build

npm install
npm run dev
npm test
npm run lint
npm run build

The production output is in dist/ and can be hosted as static files. No server-side service is required. src/projectExample.json is the included realistic sample project.

Project JSON

The schema is documented in docs/project-flow.schema.json. A project has ordered phases and departments, activities keyed to one matrix cell, internal actions linked by stable IDs, typed connections, and separate layout.nodePositions. File references are plain-text documentReference values on outputs, inherited by connected inputs and connections. There is no shared document registry. Schema version 4 is current; versions 1 through 3 migrate on import, preserving old document locations or names. Incomplete projects remain editable and receive warnings; the included example has none.

Use Open to import JSON. Save chooses a destination on the first save, then writes to the selected file where direct file access is supported; otherwise it starts a browser download. There is no separate toolbar download/export button. Feedback names the saved file or requested download. Downloads go to the location configured by the browser; an embedded browser may not expose that location. Cancelled or denied save dialogs do not mark edits saved, and a requested download is not treated as a confirmed disk write. File-error messages retain a Download JSON recovery command.

Editing

Drag an activity card to an empty matrix cell to change its phase and department. Empty destinations are highlighted during dragging; occupied cells reject the move. Contents and connections are preserved, and moves support undo, redo, and saving.

Use Structure to add phases and departments through in-app forms and edit the project description. Drag headings to reorder; clicking them does not resize cells. Move activities only by dragging them in the matrix; the activity editor has no phase/department selectors. Frozen headers sit outside the scrolling cell area, so the scrollbars align with the nonfrozen rows and columns. Select an empty cell to create an activity and an activity card to open its fullscreen editor. A matrix route opens only its connection properties, without navigating. Inputs choose a single source output from a dropdown grouped by activity. Outputs may feed several successor activities, once per activity. Output descriptions and file references propagate to connected inputs. Output IDs are generated automatically and hidden. Wrapped navigation links are underlined on every line. The project name is editable in the matrix toolbar beside its connection legend, not in the titlebar; there is no duplicate project ribbon. There is no Files tool, Connect button, or minimap. Checks shows validation issues. Undo/redo covers all model changes, including moves and structure edits.

Deleting a phase, department, or activity asks for confirmation where references may be affected. Activities and their connections are removed together. Clearing a file reference on an output clears it on every connected input and connection. Reordering phases or moving activities updates feedback-loop classification automatically.

Implementation notes

Unknown schema versions are reported as structural validation errors. Matrix routes use DOM-measured cubic paths anchored to activity cards; they do not run global crossing minimization. Route hit-testing is disabled during activity dragging so lines cannot intercept drops. File handles remain subject to browser permission and availability, and external-file change detection uses the file's modification timestamp before saving.

About

A workflow matrix builder.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages