Welcome to the Vitistack documentation repository! This site is built with MkDocs Material and features a custom accessibility-focused theme.

# Setup Python virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install --upgrade pip
pip install -r mkdocs-requirements.txt
npm install

# Serve locally
mkdocs serve

# or with live reload
mkdocs serve --livereload

# Build for production
mkdocs build

# Run accessibility tests (automatically sets up venv)
./test-accessibility.sh

# Manual setup with venv
source venv/bin/activate
npm run test:axe
npm run test:pa11y
npm run test:lighthouse

• Custom Viti Theme: Brand-aligned colors and styling
• Accessibility First: WCAG 2.1 AA compliant
• Dark Mode Support: Full theme with accessibility considerations
• Responsive Design: Mobile-first approach
• CI/CD Pipeline: Automated accessibility testing

This documentation is built with accessibility as a core principle:

• ✅ WCAG 2.1 AA compliance
• ✅ Screen reader support
• ✅ Keyboard navigation
• ✅ High contrast mode
• ✅ Reduced motion support

For detailed information about our accessibility features and testing, see ACCESSIBILITY.md.

• Static Site Generator: MkDocs
• Theme: Material for MkDocs (customized)
• Accessibility Testing: Axe Core, Pa11y, Lighthouse
• CI/CD: GitHub Actions
• Hosting: GitHub Pages

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run accessibility tests: ./test-accessibility.sh
5. Submit a pull request

All contributions are automatically tested for accessibility compliance.

This project is licensed under the terms specified in the LICENSE file.