A Progressive Web App (PWA) enabling State Medicaid Agencies (SMAs) to self-assess their Medicaid Enterprise maturity using the MITA 4.0 Maturity Model.
The MITA 4.0 State Self-Assessment Tool helps State Medicaid Agencies evaluate their Medicaid Enterprise Systems (MES) maturity across 66 capability areas using the standardized ORBIT Maturity Model. The tool is:
- Privacy-First: All data stays in your browser. No data is transmitted or stored remotely.
- Offline-First: Full functionality after initial load, even without network connectivity.
- Accessible: WCAG 2.1 AA compliant for government use.
ORBIT is the MITA 4.0 maturity assessment framework. Each business capability area is assessed against three required dimensions:
| Dimension | Aspects |
|---|---|
| Business Architecture | 5 |
| Information | 10 |
| Technology | 11 (across 2 sub-dimensions) |
Three additional organizational assessments evaluate enterprise-level maturity (assessed once per organization, not per capability area):
| Organizational Assessment | Aspects |
|---|---|
| Organizational Outcomes (Optional) | 6 |
| Organizational Roles (Optional) | 5 |
| Organizational Enterprise Architecture | 4 |
Outcomes and Roles ("O" and "R" in the original ORBIT acronym) were extracted from per-capability assessments to enterprise-level assessments because they describe organizational maturity rather than per-capability maturity.
Each aspect is rated on a 5-level maturity scale:
- Level 1: Initial
- Level 2: Developing
- Level 3: Defined
- Level 4: Managed
- Level 5: Optimized
- N/A: Not Applicable
- Hierarchical view of all 16 capability domains and 66 areas grouped by layer (Strategic, Core, Support)
- Progress tracking with visual indicators
- Tag-based organization and filtering
- Assessment history with snapshots
- Guided assessment through all ORBIT dimensions
- Question checklists and evidence tracking per maturity level
- File attachment support (PDF, DOC, XLS, images)
- Auto-save with debounced updates
- Notes, barriers, and advancement plans per aspect
- Overall maturity scores and visualizations
- Domain and capability area breakdowns
- Strengths and gaps analysis
- Radar charts and comparison views
- PDF: Professional reports for stakeholders
- CSV: CMS Maturity Profile standard format
- JSON: Full data backup and restore
- ZIP: Complete package with attachments
- Node.js 18+
- npm 9+
# Clone the repository
git clone https://github.com/your-org/mita-4.0-ssa.git
cd mita-4.0-ssa/mita-4.0
# Install dependencies
npm install
# Start development server
npm run devThe app will be available at http://localhost:5173
# Build
npm run build
# Preview production build
npm run previewmita-4.0/
├── src/
│ ├── components/ # React components by feature
│ │ ├── assessment/ # ORBIT assessment UI
│ │ ├── dashboard/ # Dashboard components
│ │ ├── export/ # Import/export dialogs
│ │ ├── layout/ # Header, footer, navigation
│ │ └── results/ # Results visualization
│ ├── data/ # Static JSON data files
│ │ ├── capabilities.json # 75 capability areas
│ │ └── orbit-model.json # ORBIT maturity criteria
│ ├── hooks/ # Custom React hooks
│ ├── pages/ # Route page components
│ ├── services/ # Business logic & utilities
│ │ └── export/ # Export handlers
│ ├── types/ # TypeScript interfaces
│ ├── theme/ # MUI theme customization
│ └── utils/ # Utility functions
├── docs/ # MITA 4.0 reference documents
└── public/ # Static assets
| Layer | Technology |
|---|---|
| Build | Vite 6 |
| Framework | React 18 |
| Language | TypeScript (strict mode) |
| Routing | React Router v7 |
| UI | Material UI v6 |
| State | React Hooks + Dexie React Hooks |
| Storage | Dexie.js (IndexedDB) |
| PDF Export | jsPDF + jsPDF-AutoTable |
| ZIP Export | JSZip |
| Charts | Chart.js + react-chartjs-2 |
| Testing | Vitest + React Testing Library |
# Development
npm run dev # Start dev server
npm run build # Production build
npm run preview # Preview production build
# Code Quality
npm run lint # ESLint check
npm run lint:fix # ESLint auto-fix
npm run format # Prettier format
npm run format:check # Prettier check
npm run typecheck # TypeScript type check
npm run audit:code # Detect unused code (knip)
# Testing
npm test # Run tests once
npm run test:watch # Watch mode
npm run test:coverage # Coverage reportThe application uses two primary JSON files that can be edited to update capabilities or ORBIT criteria:
Defines what can be assessed:
- 16 capability domains across 3 layers (Strategic, Core, Support)
- 66 capability areas with descriptions and topics
- Two domains use sub-categories (Enterprise Data Management, Enterprise Technology)
- No maturity questions—just metadata
Defines how assessments are conducted:
- 3 standard dimensions (B, I, T) with 26 total aspects applied to every capability area
- 3 organizational assessments (Outcomes, Roles, Enterprise Architecture) with 15 total aspects assessed once per organization
- Standardized maturity criteria with descriptions and "Suggested Documentation" per maturity level
- Sourced verbatim from the May 3, 2026 PRA submission
All user data is stored locally:
- Capability assessments (one per area)
- ORBIT ratings (one per aspect per assessment)
- File attachments (stored as Blobs)
- Assessment history (snapshots)
- Tags for organization
- Chrome 90+
- Firefox 90+
- Safari 15+
- Edge 90+
Requires IndexedDB and Service Worker support for full PWA functionality.
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes
- Run tests (
npm test) - Run linting (
npm run lint) - Commit with conventional commits (
git commit -m 'feat: add amazing feature') - Push to your branch (
git push origin feature/amazing-feature) - Open a Pull Request
- PROJECT_FOUNDATION_v2.md - Architecture and design decisions
- CHANGELOG.md - Version history
- docs/source-documents/ - Source MITA documents archived by date
- docs/reference/ - Reference snapshots of the capability model and maturity criteria
- docs/decisions/ - Historic spec/decision records
This project is licensed under the GPLv3 (GNU General Public License Version 3) License - see the LICENSE file for details.
- MITA Governance Board
- MITA 4.0 Workgroup
- Centers for Medicare & Medicaid Services (CMS)