---
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:

```text
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.