Files

T

AFFAANhandClaude Opus 5 b42b7406dc Initial commit: MaskanX frontend

Independent React, TypeScript and Vite web application for MaskanX.

Includes the chat console, agent and persona configuration, MCP client
management, model and provider settings, cron jobs, sessions, and
diagnostics.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-01 10:28:39 +05:30

1.3 KiB

Raw Blame History

MaskanX Frontend

Independent React, TypeScript, and Vite frontend for MaskanX.

Service Contract

Default development URL: http://127.0.0.1:5173
Backend API: configured with VITE_MASKANX_API_URL
Local proxy target: configured with VITE_MASKANX_PROXY_TARGET
Database access: none; this service never receives PostgreSQL credentials

Local Setup

npm install
Copy-Item .env.local.example .env.local
npm run local

Start maskanx-backend on port 8088 before using the full UI.

Commands

Command	Purpose
`npm run start`	Preview the production build on port 5173
`npm run build`	Type-check and build `dist/`
`npm run local`	Local Vite server using `.env.local`
`npm run dev`	Development server using `.env.development`
`npm run test`	Test-mode type-check and production build
`npm run lint`	ESLint checks
`npm run prod`	Production-mode preview

Database migration and seed commands intentionally live in maskanx-backend. A frontend must never own database credentials.

Production

Build the container with the browser-visible backend URL:

docker build `
  --build-arg VITE_MASKANX_API_URL=https://api.example.com `
  -t maskanx-frontend .

The backend must allow the deployed frontend origin through MASKANX_CORS_ORIGINS.