https://github.com/hassanzouhar/monotropism_saq
Monotropism Questionnaire
https://github.com/hassanzouhar/monotropism_saq
adhd audhd autism mentalhealth selfassessment
Last synced: 4 months ago
JSON representation
Monotropism Questionnaire
- Host: GitHub
- URL: https://github.com/hassanzouhar/monotropism_saq
- Owner: hassanzouhar
- Created: 2025-07-02T21:55:03.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-09-11T23:44:11.000Z (9 months ago)
- Last Synced: 2025-09-12T00:27:20.454Z (9 months ago)
- Topics: adhd, audhd, autism, mentalhealth, selfassessment
- Language: TypeScript
- Homepage: https://monotropism.rastla.us
- Size: 55.1 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Monotropism Questionnaire (MQ)
This project is a web-based implementation of the Monotropism Questionnaire (MQ), a research-validated instrument designed to measure a monotropic cognitive style. It was developed by autistic scholars and is based on the theory of monotropism.
This application provides an interactive and user-friendly interface for individuals to take the questionnaire, receive a score, and understand their results in the context of recent research.
## Features
- **Interactive Questionnaire:** A 47-item questionnaire with a user-friendly, multi-step interface.
- **Progress Tracking:** Visual indicators for overall and section-specific progress.
- **Detailed Results:** Calculates an overall monotropism score and a profile across eight distinct factors.
- **Score Interpretation:** Provides context and interpretation for the scores based on the validation study (Garau et al., 2023).
- **Contextual Information:** Includes background on monotropism theory and important considerations for interpreting the results.
- **Responsive Design:** Built with Tailwind CSS for a seamless experience across different devices.
## Tech Stack
- **React:** A JavaScript library for building user interfaces.
- **TypeScript:** A typed superset of JavaScript that compiles to plain JavaScript.
- **Vite:** Modern build tool and development server for faster development.
- **Tailwind CSS:** A utility-first CSS framework for rapid UI development.
- **Lucide React:** A library of simply designed, beautiful icons.
- **@vercel/analytics:** Analytics integration for production deployment.
## Getting Started
To run this project locally, follow these steps:
### Prerequisites
- **Node.js:** Version 18.0.0 or higher
- **npm:** Version 10.0.0 or higher
### Setup
1. **Clone the repository:**
```bash
git clone
cd monotropism_saq
```
2. **Install dependencies:**
```bash
npm install
```
3. **Start the development server:**
```bash
npm run dev
# or
npm start
```
This will start the Vite development server and open the application in your default browser at `http://localhost:3000`.
## Available Scripts
- **`npm run dev`** - Start the development server with hot module replacement
- **`npm start`** - Alternative command to start the development server
- **`npm run build`** - Build the project for production deployment
- **`npm run preview`** - Preview the production build locally
## Recent Updates
### Migration to Vite (2024)
This project has been migrated from Create React App to Vite for improved performance and security:
**Benefits:**
- ⚡ **Faster Development:** Vite's development server starts in milliseconds vs seconds
- 🔒 **Enhanced Security:** Eliminated all npm security vulnerabilities by removing react-scripts dependencies
- 📦 **Smaller Bundle:** Reduced dependencies from 1,500+ to ~80 packages
- 🛠️ **Better DX:** Improved TypeScript support and Hot Module Replacement (HMR)
- 🏗️ **Modern Tooling:** Uses ESBuild for lightning-fast builds
**Breaking Changes:**
- Development command changed from `npm start` to `npm run dev` (though `npm start` still works)
- Build output directory remains `build/` for compatibility
- All existing functionality preserved
## Deployment
The project is optimized for deployment on modern platforms:
- **Vercel:** Includes `@vercel/analytics` integration
- **Build Output:** Static files in `build/` directory
- **Node.js Requirements:** Compatible with Node.js 18+ environments
## Troubleshooting
### Node Version Issues
If you encounter errors about Node.js version compatibility:
1. **Check your Node.js version:**
```bash
node --version
```
2. **Update to Node.js 18+ if needed:**
- Using fnm: `fnm use 18` or `fnm install 18`
- Using nvm: `nvm use 18` or `nvm install 18`
- Download from [nodejs.org](https://nodejs.org/)
### Development Server Issues
If the development server doesn't start:
1. **Clear node_modules and reinstall:**
```bash
rm -rf node_modules package-lock.json
npm install
```
2. **Try different ports if 3000 is busy:**
```bash
npm run dev -- --port 3001
```
### Build Issues
If the build fails:
1. **Check for TypeScript errors:**
```bash
npx tsc --noEmit
```
2. **Clear Vite cache:**
```bash
rm -rf .vite
npm run build
```
## Disclaimer
This questionnaire is not a diagnostic tool for autism or ADHD. It is an instrument for measuring a cognitive style. The results should be interpreted as indicative of monotropic traits and not as a clinical diagnosis.
## Attribution
This questionnaire is based on the work of the following researchers:
Garau, V., Woods, R., Chown, N., Hallett, S., Murray, F., & Murray, D. (2023). The Monotropism Questionnaire, Open Science Framework.