Skip to content
Tiffany Forkner edited this page Mar 4, 2025 · 10 revisions

Welcome to Mako!

macpro-mako (also known as Mako or Micro) is a project by the CMS MACPRO Platform Team. The software is responsible for Medicaid, CHIP, and Waiver submissions, which are essential for customizing healthcare programs to meet state-specific needs. States submit these documents for review and approval by CMS, ensuring compliance with federal regulations while addressing their unique healthcare priorities. While macpro-mako is a redesign of MACPRO OneMac, the mission to be a modern submission and review portal for CMS and the States remains the same.


Brief Overview of Architecture

macpro-mako is built around a software pattern known as Command Query Responsibility Segregation (CQRS), where reading and writing submissions are handled by separate systems:

The endpoints are "serverless," relying on AWS Lambdas, and the infrastructure is provisioned by AWS CDK (Cloud Development Kit).

The stack, front to back, is written in TypeScript.

On the user-facing side of things, the frontend is built with React, Vite for bundling, and TailwindCSS for styling.

The 10,000ft View

The macpro-mako project is a redesign of MACPRO Onemac. The mission to be a modern submission and review portal for select CMS data remains the same, but the architecture is different in some important ways. Architecture

A diagram is often the best way to communicate the architecture:

image

Development Metrics (DORA)

We programmatically publish a set of Development metrics that align to the DevOps Research and Assesment (DORA) standards. Those metrics can be viewed here.

AWS Resources

You can view and download a list of all aws resources this project uses for higher environments here.


Contributions to the Wiki

Given the ever-evolving specifications of an active project, this Wiki is always a work in progress. If you have extra time, you're more than welcome to contribute!