58 lines
2.6 KiB
Markdown
58 lines
2.6 KiB
Markdown
## Version Manifest: React + Vite + MUI Rewrite
|
|
|
|
### Environment and container tooling
|
|
- macOS: 26 (host requirement)
|
|
- Container CLI: apple/container (latest release observed: 0.11.0)
|
|
- Container runtime command: container (Docker unavailable by constraint)
|
|
- Base image: node:24-trixie-slim (Node 24 LTS on Debian trixie-slim; OCI-compatible)
|
|
|
|
### Frontend stack
|
|
- Node.js runtime: 24.x LTS
|
|
- React: 19.2.5
|
|
- React DOM: 19.2.5
|
|
- TypeScript: 6.0.3
|
|
- Vite: 8.0.8
|
|
- @vitejs/plugin-react: 6.0.1
|
|
- @types/react: 19.2.14
|
|
- @types/react-dom: 19.2.3
|
|
- Material UI core: @mui/material 9.0.0
|
|
- Material UI styling engine: @emotion/react 11.14.0, @emotion/styled 11.14.1
|
|
- Optional state-fetching utility selected in plan: @tanstack/react-query 5.99.2
|
|
|
|
### Backend stack (planned)
|
|
- Node.js runtime: 24.x LTS
|
|
- Express: 5.2.1
|
|
- Zod: 4.3.6
|
|
- TypeScript: 6.0.3
|
|
|
|
### MUI knowledge/tooling
|
|
- MUI docs index for LLM consumption: https://mui.com/material-ui/llms.txt
|
|
- MUI MCP package invocation model: npx -y @mui/mcp@latest
|
|
|
|
## Compatibility Audit
|
|
|
|
### Hard compatibility checks
|
|
1. Node 24 vs Vite 8: compatible (Vite requires Node 20.19+ or 22.12+).
|
|
2. React 19.2.x vs MUI 9: compatible (MUI supports React ^17 || ^18 || ^19).
|
|
3. React 19.2.x vs react-dom 19.2.5: compatible (same major/minor line).
|
|
4. TypeScript 6 vs MUI 9: compatible (MUI requires TS >=4.9).
|
|
5. Node 24 vs Express 5.2.1: compatible (Express requires Node >=18).
|
|
6. Apple container vs Dockerfile workflow: compatible (container build supports Dockerfile and Containerfile).
|
|
|
|
### Environment-specific incompatibilities / risks
|
|
1. Docker command compatibility: incompatible by environment constraint.
|
|
- Any script that assumes docker build/run must be translated to container build/run.
|
|
2. Apple container stability: medium risk.
|
|
- Project is pre-1.0 and may introduce breaking changes in minor releases.
|
|
- Mitigation: pin CLI release during execution and document upgrade policy.
|
|
3. Slim Debian runtime package availability: low-to-medium operational risk.
|
|
- trixie-slim is smaller than full images and may omit convenience packages.
|
|
- Mitigation: install only required OS packages explicitly and validate build/runtime dependencies.
|
|
4. @mui/mcp@latest floating version: reproducibility risk.
|
|
- Mitigation: pin exact MCP package version for CI/repeatable local behavior once selected.
|
|
|
|
### Migration-policy compatibility with user constraints
|
|
1. Latest stable React only: satisfied by React 19.2.x.
|
|
2. No legacy/migration support tracks: satisfied; no React 18 fallback assumptions included.
|
|
3. MUI usage policy: satisfied with plain Material UI v9.x.x and mui-mcp-first guidance.
|