Getting Started with Mavaia

Prerequisites

Request evaluation access via /contact. We provision credentials tied to the institutional routing policy you select. You will need SSH access to your deployment target and the ability to install Ollama + Payload CMS.

• macOS or Linux host with 32GB RAM minimum
• Docker 27.x or container runtime with cgroups v2
• Node.js 20.x and pnpm 9.x for docs-as-code workflows

Install path

Clone this repository, run `pnpm install`, and execute `pnpm dev` for the Next.js front-end. Run `pnpm cms:seed` to bootstrap Payload with schema, editorial roles, and sample entries. The CMS is the source of truth for systems, evaluation notes, and long-form pages.

1. Configure environment variables from `cms/.env.example` with CMS credentials.
2. Start Payload with `pnpm payload dev` and verify health at `http://localhost:3001/admin`.
3. Start the Next.js app with `pnpm dev` and verify preview mode via `http://localhost:3000/api/draft`.

Verification

Before exposing an endpoint, run the smoke suite in `scripts/seed.ts`. It provisions evaluation note fixtures and ensures relationships to systems/publications resolve correctly.