metalisp/dev.metalisp.cardsort
2
Fork 0
Code Releases Activity
Simple card sorting
8 commits 1 branch 0 tags 19 MiB
Find a file
Exact
Marcus Kammer 0460dc8d2f
 docs: update README and architecture doc for single-file study database 
Describe the new cardsort-studies.lisp database file and the updated
safe-reading, atomic-writing, identifier-safety, and test-fixture
semantics now that studies are stored in dev.metalisp.simple-db.
2026-08-17 09:43:15 +02:00
doc docs: update README and architecture doc for single-file study database 2026-08-17 09:43:15 +02:00
src refactor(persist): switch study persistence to dev.metalisp.simple-db 2026-08-17 09:43:00 +02:00
tests refactor(persist): switch study persistence to dev.metalisp.simple-db 2026-08-17 09:43:00 +02:00
.gitignore feat(views): migrate UI layer to ml-sbt Bootstrap components 2026-08-16 15:01:31 +02:00
dev.metalisp.cardsort.asd refactor(persist): switch study persistence to dev.metalisp.simple-db 2026-08-17 09:43:00 +02:00
justfile Init commit 2026-08-16 11:37:48 +02:00
LICENSE Init commit 2026-08-16 11:37:48 +02:00
README.org docs: update README and architecture doc for single-file study database 2026-08-17 09:43:15 +02:00

README.org

dev.metalisp.cardsort

ml-cardsort

ml-cardsort is a web application for running open card sorting studies and analyzing the results.

Participants receive a link, sort cards into self-chosen groups by clicking, and the application computes how often each pair of cards was grouped together.

Prerequisites

  • Fedora Linux
  • SBCL
  • Quicklisp (installed in ~/quicklisp)
  • Just
  • dev.metalisp.sbt in ~/quicklisp/local-projects (Bootstrap component library)

All other Lisp dependencies are fetched from Quicklisp automatically.

Quickstart 

# Run the test suite
just tests

# Build and start the server
just run

Then open http://127.0.0.1:8081 in a browser.

Other recipes:

just repl    # Start SBCL with the system loaded
just build   # Compile the standalone binary ml-cardsort
just clean   # Remove the binary

Runtime configuration

Environment variable Default Purpose
MLCARDSORT_PORT 8081 HTTP port
MLCARDSORT_ADDRESS 127.0.0.1 Bind address
MLCARDSORT_DATA_DIR ~/.local/share/ml-cardsort/ Directory for the studies database file

All studies are stored in a single plain Lisp file, cardsort-studies.lisp, in the data directory.

Documentation

See doc/dev.metalisp.cardsort.org for architecture and data format details.

License

AGPL-3.0-or-later