https://github.com/adrorocker/tmt
https://github.com/adrorocker/tmt
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/adrorocker/tmt
- Owner: adrorocker
- License: mit
- Created: 2025-05-13T05:52:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-22T22:07:11.000Z (12 months ago)
- Last Synced: 2025-06-22T23:19:07.249Z (12 months ago)
- Language: HTML
- Homepage: https://adrorocker.github.io/tmt/
- Size: 105 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🧠 Trail Making Test (TMT-A & TMT-B)
A browser-based, interactive version of the **Trail Making Test (TMT)** — a neuropsychological task used to measure **processing speed**, **attention**, and **task switching**. Built for personal use and cognitive exploration, this tool runs directly in your browser with **mobile and desktop** support.
## ⚠️ Disclaimer
This web-based test is provided **only for personal or educational use**.
- It is **not a diagnostic tool** and should not be relied upon for medical evaluation.
- It is not a substitute for professional neurological or psychological assessment.
- No clinical guarantees are made regarding timing, error tolerance, or scoring interpretation.
- By using this tool, you agree that the authors and publishers are **not liable** for any misuse or misinterpretation of results.
If you are concerned about your cognitive performance, please consult a licensed healthcare provider.
## 📋 What Is the Trail Making Test?
The Trail Making Test is widely used to evaluate:
- Visual attention
- Processing speed
- Mental flexibility
- Executive functioning
It exists in two versions:
- **TMT-A**: Connect numbers in ascending order (1 → 2 → 3 … 25)
- **TMT-B**: Alternate between numbers and letters (1 → A → 2 → B … 13)
## 🎮 How to Use It
### ✅ Taking the Test Online
1. Visit the [TMT Web App](https://adrorocker.github.io/tmt/).
2. Choose between **Variant A** or **Variant B**.
3. Place your **index finger or mouse pointer** on circle **1**.
4. Click the circles in the correct order (1 → 2 → 3 ... or 1 → A → 2 → B ...).
5. The **timer will start automatically** when you click the first correct node.
6. The final node will be marked with a **"!"** upon completion.
7. View your time, errors, and feedback in the **Results Modal**.
8. Check the **Results History** screen to view past attempts, ordered by date.
📱 Mobile-friendly — just tap the circles on the screen.
## 🧪 Purpose
This test is offered for **exploring mental processing speed** in an abstract and interactive way. While based on established clinical formats, it is not meant to replicate them exactly.
- Inspired by standard cognitive assessments used in research and clinical trials
- Great for practicing attention, sequencing, and speed under mild pressure
## 🧾 Features
- ✅ Responsive full-screen canvas
- ✅ Dynamic TMT-A (up to 25 nodes) and TMT-B (up to 26 nodes, alternating numbers and letters up to M) node generation
- ✅ Performance tracking (Time, Errors)
- ✅ Historical results screen with timestamps, ordered by date
- ✅ Timer starts only when the **first node** is clicked
- ✅ "Show Next Value" toggle for guidance during the test (disabled by default, can be toggled in settings)
- ✅ Color feedback for correct (green) and incorrect (red) node selections (disabled by default, can be toggled in settings)
- ✅ Results modal with detailed feedback
- ✅ Keyboard shortcuts (e.g., press **H** to open Results History)
- ✅ Node sizes dynamically adjust based on screen resolution for better touch interaction
- ✅ TMT-B generates exactly 25 nodes, alternating between numbers and letters
## 🔐 Data Privacy
All results are stored locally using the browser's `localStorage`. This means your data remains private and is not transmitted to any server. You can delete all stored results at any time by clicking the **Delete All History** button in the **Settings** section.
## 📄 License
This project is released under the **MIT License**. See the [LICENSE](./LICENSE) file for details. Feel free to use, fork, or adapt it.
## 🙌 Authors
[Adro Morelos](https://github.com/adrorocker)