Skip to content

About

Browser-only tool for students building concept maps: enter triples in a spreadsheet table, get an auto-laid-out SVG map with live rubric validation, drag-to-adjust layout, and one-click PNG/SVG/JSON/CSV export.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

34 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Concept Map Maker

Browser-only tool for students building concept maps: enter triples in a spreadsheet table, get an auto-laid-out SVG map with live rubric validation, drag-to-adjust layout, and one-click PNG/SVG/JSON/CSV export.

Try it live: vosslab.github.io/concept-map-maker

Overview

Students in life-science courses build concept maps where bubbles hold a 1-3 word concept (noun) and directed arrows carry verb phrases ("concept maps --organize--> ideas"). This app runs entirely in the browser with no install, no account, and no backend. Students enter rows in a spreadsheet-like triples table (This concept | verb phrase | points to this concept); the app auto-generates an SVG map using dagre auto-layout, colors bubbles by graph distance from origin bubbles, validates the assignment rubric live (30+ unique concepts, a verb phrase on every arrow), and saves work automatically in localStorage. Exports include PNG, SVG, JSON, CSV, and print.

The UI includes a two-state light/dark theme toggle; the on-screen concept map adapts to the selected theme while SVG/PNG exports remain light. The app is deployed on GitHub Pages and runs with no server.

Screenshots

Dark-mode empty state with example template buttons

Dark-mode concept map of the Honeybees example with the triples table

Documentation

Getting started:

  • docs/INSTALL.md - setup steps, dependencies, and install verification
  • docs/USAGE.md - how to run the app, build maps, save work, and run dev checks

Reference:

Style and testing:

Quick start

npm install
bash build_github_pages.sh
bash run_web_server.sh

Testing

Run the full codebase check (TypeScript, ESLint, node unit tests):

bash check_codebase.sh

Run browser-driven Playwright tests:

bash run_playwright_tests.sh

Run Python hygiene tests (linting, link checks, shebang checks):

pytest tests/

License

Source code is licensed under the MIT License; see LICENSE.MIT.md. Non-code content (text, figures) is licensed under CC BY 4.0; see LICENSE.CC-BY-4.0.md.

About

Browser-only tool for students building concept maps: enter triples in a spreadsheet table, get an auto-laid-out SVG map with live rubric validation, drag-to-adjust layout, and one-click PNG/SVG/JSON/CSV export.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages