nsaspy/quasar-ui
1
0
Fork 0
Code Issues 18 Pull requests 7 Projects Releases Packages Wiki Activity Actions

[Roadmap] JS-only Quasar UI deployment plan #2

New issue
Closed
opened 2026-07-25 21:51:34 +00:00 by lost-rob0t · 0 comments
lost-rob0t commented 2026-07-25 21:51:34 +00:00 (Migrated from github.com)
Copy link

Goal

Ship quasar-ui as a browser-first, offline-first JavaScript/TypeScript spin-off of the Quasar design.

Fixed architecture

  • TypeScript, React, and Vite.
  • Cytoscape.js behind a strict graph adapter.
  • IndexedDB is the canonical local workspace store.
  • Web Workers execute local actions and heavy parsing/layout work.
  • XState models interaction, connection, action, and startup lifecycles.
  • TanStack Query manages optional remote adapter state only.
  • Optional StarIntel integration uses typed HTTP/WebSocket adapters.
  • Deployment is a static PWA; no Common Lisp backend, Node business-logic API, Rust/Tauri shell, GraphQL, or Socket.IO.
  • Manual edits, imports, and actions all produce validated graph-operation batches.
  • Dashboard, map, table, and timeline surfaces remain projections over stable identifiers rather than separate databases.

Phase 0 — Foundation

  • #3 Bootstrap the TypeScript/React/Vite workspace
  • #4 Define JS-only package boundaries and architecture rules
  • #5 Establish code quality, test, and CI baseline
  • #6 Create deterministic fixtures and schema conformance tests

Exit gate: clean checkout builds and tests; architecture boundaries are enforceable; deterministic fixtures exist.

Phase 1 — Local-first graph core

  • #7 Implement the canonical graph document and type registry
  • #8 Implement the graph command and atomic batch engine
  • #9 Implement transaction undo/redo and revision tracking
  • #10 Implement the IndexedDB workspace repository and migrations
  • #11 Implement canonical JSON, GraphML, and CSV import/export

Exit gate: graphs can be created, edited through commands, saved offline, reopened, undone/redone, imported, and exported without a server.

Phase 2 — Editable workbench MVP

  • #12 Build the resizable investigation workbench shell
  • #13 Implement the Cytoscape graph adapter and extension loader
  • #14 Implement node and edge editing gestures
  • #15 Build the typed node and edge inspector
  • #16 Persist layouts, viewport, selection, and saved graph views
  • #17 Add command palette, intermediate keymap, and workspace navigation

Exit gate: a user can open a workspace, create and connect typed nodes, edit properties, arrange the graph, save/reopen it, and operate the core editor by pointer or keyboard.

Phase 3 — JavaScript actions and optional integrations

  • #18 Implement the JavaScript action registry and applicability engine
  • #19 Build the sandboxed Web Worker action runner
  • #20 Validate and apply action graph batches as undoable transactions
  • #21 Build action progress, cancellation, logs, and trace UI
  • #22 Add the optional StarIntel HTTP/WebSocket integration adapter

Exit gate: a local worker action can be discovered, invoked, cancelled, validated, applied, and undone; remote integration remains optional.

Phase 4 — Investigation projections and dashboard

  • #23 Add the virtualized table projection
  • #24 Add the MapLibre map adapter and layer registry
  • #25 Add the timeline adapter and temporal filtering
  • #26 Implement shared selection, filters, and time synchronization
  • #27 Implement dashboard manifests, panel registry, and layout persistence
  • #28 Implement the projection coordinator, freshness states, and refresh scheduler
  • #29 Add CodeMirror structured-data and Star-Lang editor integration
  • #30 Add the evidence and document inspection surface

Exit gate: graph, table, map, timeline, dashboard, editor, and document views coordinate through stable IDs without creating duplicate canonical stores.

Phase 5 — Production deployment

  • #31 Package Quasar UI as an installable offline PWA
  • #32 Add secure local file workflows and recovery
  • #33 Harden CSP, imports, rendering, and extension boundaries
  • #34 Complete accessibility, responsive, and touch support
  • #35 Add performance workers, fixtures, and CI budgets
  • #36 Build production GitHub Actions and static deployment
  • #37 Add release versioning, diagnostics, and operational documentation

Exit gate: the static PWA is reproducibly deployed, installable, offline-capable, secure under its CSP, accessible, performance-budgeted, recoverable, versioned, and rollback-ready.

Production readiness

  • All phase exit gates pass.
  • Canonical graph and storage migrations pass against every retained fixture.
  • Offline reload, service-worker update, backup, restore, and rollback are tested.
  • No deployment path requires Common Lisp, Node server business logic, Rust, or Tauri.
  • Optional integrations fail closed without preventing local graph editing.
## Goal Ship `quasar-ui` as a browser-first, offline-first JavaScript/TypeScript spin-off of the Quasar design. ## Fixed architecture - TypeScript, React, and Vite. - Cytoscape.js behind a strict graph adapter. - IndexedDB is the canonical local workspace store. - Web Workers execute local actions and heavy parsing/layout work. - XState models interaction, connection, action, and startup lifecycles. - TanStack Query manages optional remote adapter state only. - Optional StarIntel integration uses typed HTTP/WebSocket adapters. - Deployment is a static PWA; no Common Lisp backend, Node business-logic API, Rust/Tauri shell, GraphQL, or Socket.IO. - Manual edits, imports, and actions all produce validated graph-operation batches. - Dashboard, map, table, and timeline surfaces remain projections over stable identifiers rather than separate databases. ## Phase 0 — Foundation - [ ] #3 Bootstrap the TypeScript/React/Vite workspace - [ ] #4 Define JS-only package boundaries and architecture rules - [ ] #5 Establish code quality, test, and CI baseline - [ ] #6 Create deterministic fixtures and schema conformance tests **Exit gate:** clean checkout builds and tests; architecture boundaries are enforceable; deterministic fixtures exist. ## Phase 1 — Local-first graph core - [ ] #7 Implement the canonical graph document and type registry - [ ] #8 Implement the graph command and atomic batch engine - [ ] #9 Implement transaction undo/redo and revision tracking - [ ] #10 Implement the IndexedDB workspace repository and migrations - [ ] #11 Implement canonical JSON, GraphML, and CSV import/export **Exit gate:** graphs can be created, edited through commands, saved offline, reopened, undone/redone, imported, and exported without a server. ## Phase 2 — Editable workbench MVP - [ ] #12 Build the resizable investigation workbench shell - [ ] #13 Implement the Cytoscape graph adapter and extension loader - [ ] #14 Implement node and edge editing gestures - [ ] #15 Build the typed node and edge inspector - [ ] #16 Persist layouts, viewport, selection, and saved graph views - [ ] #17 Add command palette, intermediate keymap, and workspace navigation **Exit gate:** a user can open a workspace, create and connect typed nodes, edit properties, arrange the graph, save/reopen it, and operate the core editor by pointer or keyboard. ## Phase 3 — JavaScript actions and optional integrations - [ ] #18 Implement the JavaScript action registry and applicability engine - [ ] #19 Build the sandboxed Web Worker action runner - [ ] #20 Validate and apply action graph batches as undoable transactions - [ ] #21 Build action progress, cancellation, logs, and trace UI - [ ] #22 Add the optional StarIntel HTTP/WebSocket integration adapter **Exit gate:** a local worker action can be discovered, invoked, cancelled, validated, applied, and undone; remote integration remains optional. ## Phase 4 — Investigation projections and dashboard - [ ] #23 Add the virtualized table projection - [ ] #24 Add the MapLibre map adapter and layer registry - [ ] #25 Add the timeline adapter and temporal filtering - [ ] #26 Implement shared selection, filters, and time synchronization - [ ] #27 Implement dashboard manifests, panel registry, and layout persistence - [ ] #28 Implement the projection coordinator, freshness states, and refresh scheduler - [ ] #29 Add CodeMirror structured-data and Star-Lang editor integration - [ ] #30 Add the evidence and document inspection surface **Exit gate:** graph, table, map, timeline, dashboard, editor, and document views coordinate through stable IDs without creating duplicate canonical stores. ## Phase 5 — Production deployment - [ ] #31 Package Quasar UI as an installable offline PWA - [ ] #32 Add secure local file workflows and recovery - [ ] #33 Harden CSP, imports, rendering, and extension boundaries - [ ] #34 Complete accessibility, responsive, and touch support - [ ] #35 Add performance workers, fixtures, and CI budgets - [ ] #36 Build production GitHub Actions and static deployment - [ ] #37 Add release versioning, diagnostics, and operational documentation **Exit gate:** the static PWA is reproducibly deployed, installable, offline-capable, secure under its CSP, accessible, performance-budgeted, recoverable, versioned, and rollback-ready. ## Production readiness - [ ] All phase exit gates pass. - [ ] Canonical graph and storage migrations pass against every retained fixture. - [ ] Offline reload, service-worker update, backup, restore, and rollback are tested. - [ ] No deployment path requires Common Lisp, Node server business logic, Rust, or Tauri. - [ ] Optional integrations fail closed without preventing local graph editing.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
ui-core-shell-overhaul
agent/draggable-graph-editor
agent/document-runtime-capability-boundary
agent/remove-browser-melissa-actors
fix/adaptive-large-graph-rendering
feat/documents-search-pagination
fix/mobile-menu-desktop-nav-parity
fix/provider-brand-icons
agent/mirror-lisp-kinpaku-navigation
design/unify-workbench-shell
fix/db-offline-status-visual
agent/fix-mobile-empty-graph
agent/guard-graph-scale
agent/url-dataset-scope
agent/add-starintel-discord-footer
agent/melissa-test-console-logging
agent/remove-bad-personator-probe
fix/melissa-exact-key
feat/graph-document-type-icons
fix/melissa-manual-test
fix/mobile-pan-after-actor
fix/melissa-explicit-credential
fix/melissa-credit-license-key
fix/production-blank-screen
fix/melissa-refresh-runtime-pack
fix/melissa-error-responses
fix/full-viewport-modern-shell
agent/opaque-origin-custom-actors
agent/agents-actor-studio
agent/performance-audit-fixes
agent/audit-security-integrity-fixes
perf/large-graph-responsiveness
agent/normalize-melissa-actor-inputs
agent/fix-personator-document-name
agent/dataset-menu-pwa-install
agent/review-and-actor-config
agent/run-all-transformations
agent/adaptive-node-scale-zoom
agent/speed-up-graph-zoom
agent-bootstraping
agent/import-without-manifest
fix/graph-viewport-workspace
agent/melissa-actor-pack
graph-workspace-shell
agent/port-exact-graph-controls
agent/issue-104-research-queue
agent/issue-104-research-node-editor
agent/issue-104-research-node-graph-ui
agent-config-pack-import
agent/auto-dig-quasar-fork
agent/research-nodes-browser-actors
agent/spec-driven-graph-editors
agent/issue-10-indexeddb-workspaces
agent/issue-100-target-actors
agent/issue-99-graph-destructive-ops
agent/issue-97-dataset-picker
agent/issue-9-graph-history
agent/issue-8-command-engine
agent/issue-7-graph-core
agent/center-mobile-empty-state
agent/compact-graph-tool-tray
agent/fullscreen-graph-buttons
agent/fullscreen-graph-buttons-v2
agent/issue-6-deterministic-fixtures
agent/radial-graph-parity
agent/maltego-layout-topographies
agent/searchable-chat-picker-v2
agent/searchable-chat-picker
agent/fullscreen-graph-v2
agent/fullscreen-graph-placement
agent/mobile-fit-agent-disclosures
fix/dashboard-theme-cards
agent/mobile-top-menu
agent/mobile-graph-gestures
agent/enable-graph-web-scraping
agent/force-open-agent-chat
agent/open-agent-chat-button
agent/mobile-graph-dropdown-themes
feat/agent-web-mcp-skills
feat/agent-operator-system
agent/graph-workbench-list
fix/mobile-editor-overlay-target-order
agent/issue-4-package-boundaries
agent/mobile-graph-controls
agent/center-mobile-dashboard
agent/mobile-first-pwa
agent/stabilize-graph-viewport-picker
agent/fix-custom-domain-base-path
agent/simplify-object-editor
feat/simplify-document-editor
feat/actor-transform-plans-clean
feat/spec-driven-document-editor
feat/actor-transform-plans
feat/compact-node-palette
codex/issue-5-phase-0-establish-code-quality-test-and-ci-basel-a1
fix/graph-drag-viewport
fix/empty-graph-context-menu
codex/issue-2-roadmap-js-only-quasar-ui-deployment-plan-a1
feat/manual-graph-actor-workflow
codex/issue-3-phase-0-bootstrap-the-typescript-react-vite-work-a1
agent/issue-3-typescript-foundation
fix/issue-41-cytoscape-warnings
fix/issue-42-relation-import-runtime
feat/issue-40-import-open-graph
fix/issue-39-atomic-imports
agent/browser-local-first-workbench
agent/dashboard-graph-routing
No results found.
Labels
Clear labels   
bug
Something isn't working

  
documentation
Improvements or additions to documentation

  
duplicate
This issue or pull request already exists

  
enhancement
New feature or request

  
good first issue
Good for newcomers

  
help wanted
Extra attention is needed

  
invalid
This doesn't seem right

  
needs-review

   
quasar

   
question
Further information is requested

  
wontfix
This will not be worked on

No labels
bug
documentation
duplicate
enhancement
good first issue
help wanted
invalid
needs-review
quasar
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
nsaspy/quasar-ui#2
No description provided.