autism-tests

🧠 Autism Tests Platform

A comprehensive web-based platform for autism spectrum disorder (ASD) assessment and screening tools. This platform provides evidence-based assessment instruments designed to support early identification and intervention.

⚠️ Important Disclaimer

This platform is for screening and educational purposes only and does not provide medical diagnosis. A comprehensive evaluation by qualified healthcare professionals is required for autism diagnosis. These tools should be used as part of a broader assessment process.

🌟 Features

🚀 Quick Start

🌐 Use it live (GitHub Pages)

The platform runs entirely in your browser — no server, no installation:

👉 https://huskynarr.github.io/autism-tests/

Every push to main automatically lints, tests, builds and publishes the site via the GitHub Actions workflow in .github/workflows/deploy.yml.

One-time repository setup: go to Settings → Pages → Build and deployment → Source and select “GitHub Actions”. After the next push to main the site is live at the URL above.

🏗️ Build & Deploy (GitHub Pages)

Statisches Deployment (empfohlen für GitHub Pages)

  1. Build-Verzeichnis vorbereiten:
    • Kopiere den Inhalt von public/ und das gesamte Verzeichnis assets/ in ein neues Verzeichnis, z.B. dist/.
    • Beispiel: 
      mkdir -p dist/assets
cp -r public/* dist/
cp -r assets dist/
  2. GitHub Pages konfigurieren:
    • Gehe zu den Repository-Einstellungen → Pages.
    • Wähle als Quelle das Verzeichnis /dist (oder /docs, je nach Workflow).
    • Alternativ kannst du den Inhalt direkt in das /docs-Verzeichnis kopieren und dieses als Pages-Root nutzen.
  3. Wichtige Hinweise:
    • Es ist kein Node.js-Server nötig, alles läuft clientseitig im Browser.
    • Die Startdatei muss index.html heißen.
    • Die Pfade zu CSS/JS/Assets müssen relativ oder ab Root (/assets/...) sein.
    • API-Endpunkte werden nicht benötigt, alle Logik läuft im Browser.
  4. Optional: Automatisierung
    • Du kannst ein einfaches Skript in package.json ergänzen: 
      "scripts": {
  ...
  "build:static": "mkdir -p dist/assets && cp -r public/* dist/ && cp -r assets dist/"
}
    • Dann einfach npm run build:static ausführen und /dist deployen.

Prerequisites

Installation

  1. Clone the repository: 
    git clone https://github.com/Huskynarr/autism-tests.git
cd autism-tests
  2. Install dependencies: 
    npm install
  3. Start the development server: 
    npm start
  4. Open your browser: Navigate to http://localhost:3000

📚 Available Assessment Tools

1. Autism Spectrum Quotient (AQ)

2. Modified Checklist for Autism in Toddlers (M-CHAT)

3. Social Responsiveness Scale (SRS)

🛠️ Development

Project Structure

autism-tests/
├── src/
│   ├── core/
│   │   └── TestEngine.js          # Core testing functionality
│   ├── assessment/
│   │   └── AutismAssessment.js    # Session management
│   └── index.js                   # Main application entry
├── public/
│   └── index.html                 # Web interface
├── assets/
│   ├── styles.css                 # Styling
│   └── app.js                     # Frontend JavaScript
├── tests/
│   └── autism-tests.test.js       # Test suite
├── docs/                          # Documentation
├── package.json                   # Project configuration
└── README.md                      # This file

Available Scripts

API Endpoints

Health Check

GET /api/health

Returns platform health status.

Get Available Tests

GET /api/tests

Returns list of available assessment tools.

Start Assessment

POST /api/assessment/start
Content-Type: application/json

{
  "testId": "aq-test",
  "participantInfo": {},
  "userAgent": "...",
  "language": "en",
  "timezone": "UTC"
}

Get Session Status

GET /api/assessment/{sessionId}

Submit Answer

POST /api/assessment/{sessionId}/answer
Content-Type: application/json

{
  "value": "3"
}

🧪 Testing

The platform includes comprehensive tests covering:

Run tests with:

npm test

For continuous testing during development:

npm run test:watch

🔧 Configuration

Environment Variables

Create a .env file in the root directory:

PORT=3000
NODE_ENV=development
SESSION_SECRET=your-secret-key
LOG_LEVEL=info

ESLint Configuration

The project uses ESLint for code quality. Configuration is in .eslintrc.js:

module.exports = {
    env: {
        node: true,
        es2021: true,
        jest: true
    },
    extends: ['eslint:recommended'],
    parserOptions: {
        ecmaVersion: 2021,
        sourceType: 'module'
    },
    rules: {
        'no-console': 'warn',
        'no-unused-vars': 'error',
        'prefer-const': 'error'
    }
};

📖 Clinical Background

Scientific Basis

All assessment tools included in this platform are based on peer-reviewed research:

Interpretation Guidelines

Results are provided with appropriate context and limitations:

🔐 Privacy & Security

🌍 Accessibility

The platform is designed to be accessible to all users:

🤝 Contributing

We welcome contributions to improve the platform:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit changes: git commit -m 'Add amazing feature'
  4. Push to branch: git push origin feature/amazing-feature
  5. Open a Pull Request

Development Guidelines

📋 Roadmap

Planned Features

Version History

📞 Support & Resources

Getting Help

Professional Resources

Community Resources

⚖️ Legal & Ethics

License

This project is licensed under the MIT License - see the LICENSE file for details.

Ethical Considerations

Citation

If you use this platform in research or clinical practice, please cite:

Autism Tests Platform (2024). Open-source autism screening tools.
GitHub repository: https://github.com/Huskynarr/autism-tests

📊 Technical Specifications

System Requirements

Performance

Security

🙏 Acknowledgments

Built with ❤️ for the autism community

For questions, support, or collaboration opportunities, please reach out through GitHub Issues or Discussions.

This site is open source. Improve this page.