owner: gmikcon status: draft last_reviewed: 2026-05-09 review_interval: 30d confidence: high

source_of_truth: owner-confirmed

Gnexus Book UI

The Gnexus Book UI should be a custom Vue.js application based on gnexus-ui-kit.

gnexus-ui-kit is the official UI kit and design-system layer for Gnexus projects. It should be consumed as a dependency so the shared visual style can be managed centrally across projects.

Source UI kit repository:

https://git.gnexus.space/root/gnexus-ui-kit

MVP Role

The first UI is not a document editor.

It should provide:

• documentation browsing;
• inventory browsing;
• validation and freshness reports;
• traffic route inspection;
• recent local change or commit inspection if practical.

All write operations should initially go through the backend API and agent workflows.

Frontend Decision

Use:

• Vue.js;
• gnexus-ui-kit as a dependency;
• the FastAPI backend under server/.

Do not replace this with MkDocs as the primary UI.

Avoid copying UI kit styles into this project unless there is a temporary integration reason. Prefer upstream changes in gnexus-ui-kit for shared style decisions.

Local Dependency

The current local development dependency is:

"gnexus-ui-kit": "file:../../gnexus-ui-kit"

This keeps the UI kit as a package dependency while allowing local updates to the official kit source.

Development

cd ui
npm install
npm run dev

The dev server runs on port 3006 and proxies /api/* to the FastAPI backend on 127.0.0.1:3005.