Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
fe00982
feat(frontend): add static evidence explorer and release frontend
AdityasagarR123 Sep 30, 2026
eee741a
style(frontend): streamline header and footer branding and layout
AdityasagarR123 Sep 30, 2026
b810c54
style(frontend): add distinct navbar container and responsive hover e…
AdityasagarR123 Sep 30, 2026
598406c
fix(frontend): update visual screenshots to current design and remove…
AdityasagarR123 Sep 30, 2026
bf853e6
style(frontend): update typography to Plus Jakarta Sans and regenerat…
AdityasagarR123 Oct 1, 2026
7cfa592
feat(frontend): add smooth fade-in animation on loading and route tra…
AdityasagarR123 Oct 1, 2026
17ea94d
style(frontend): increase fade-in duration to 0.8s for smoother entrance
AdityasagarR123 Oct 1, 2026
87a2695
feat(frontend): apply complete frontend redesign with container scrol…
AdityasagarR123 Oct 1, 2026
b079c78
docs(frontend): update PR handoff and validation report for frontend …
AdityasagarR123 Oct 1, 2026
2ce650a
feat(ui): integrate GlowCard spotlight hover effect and refine footer…
AdityasagarR123 Oct 1, 2026
31a4419
fix(ui): remove sample label & research preview, make mobile footer n…
AdityasagarR123 Oct 1, 2026
86b8166
fix(mobile): arrange footer page links in single scrollable row on mo…
AdityasagarR123 Oct 1, 2026
12ecb39
fix(mobile): arrange footer page links in 2 lines with 3 above and 2 …
AdityasagarR123 Oct 1, 2026
c20b1b7
fix(mobile): restore full glassmorphic card styling and content to re…
AdityasagarR123 Oct 1, 2026
1339507
fix(frontend): address CodeRabbit review feedback on config, contract…
AdityasagarR123 Oct 2, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions frontend/.env.example
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Defaults to the explicitly synthetic snapshot bundled in public/data.
VITE_DATA_MODE=fixture
VITE_SNAPSHOT_PATH=data/snapshot.json
# Optional fixed deployment prefix. Default ./ supports any static directory.
# VITE_BASE_PATH=/OpenVerifiableLLM/
# Development only. Has no effect in production builds.
# VITE_SCENARIO=empty
# VITE_MOCK_INFERENCE=true
5 changes: 5 additions & 0 deletions frontend/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
node_modules/
dist/
playwright-report/
test-results/
.env.local
29 changes: 29 additions & 0 deletions frontend/CHECKLIST.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Contributor brief checklist

| Requirement | Delivered evidence / remaining input |
| --- | --- |
| Overview, explorer/detail, releases, verification and inference view | All six implemented in src/pages.tsx; all adapt to mobile. |
| Explain project and inspect source-to-release process | Overview includes purpose, seven declared stages, source references and separate workflow disclosure. |
| No fake released model | Two unavailable role cards; downloads disabled; production inference always unavailable. |
| Explicit fixtures and no success fallback | Persistent fixture disclosure; schema/mode validation; public mode rejects synthetic evidence even with approval fields; loader fails closed. |
| Named, scoped results | Check profile/scope/result/explanation/operator/attestation and evidence IDs; publisher/project/consumer/independent attribution separated. |
| Empty checks never overall success | Tested empty snapshot; no overall verification verdict exists. |
| Pilot versus production | Scope filters and record scope; synthetic pilot pass retains production NOT_RUN. |
| Missing/invalid/unsupported evidence | Invalid/schema/HTTP states; missing detail routes and supporting reference warnings; UNAVAILABLE/UNSUPPORTED check results. |
| Digest copy and accessible feedback | Full digest; Clipboard API result checked; failure fallback to manual copying. |
| Parent/child/superseded report navigation | Stable hash routes; missing references visible; original failed reports preserved. |
| Original evidence references | HTTPS-only links and raw supplied revisions/paths; null values stay unknown. Default synthetic records do not invent original artifact URLs. |
| Approved real metadata traceability | Schema and configuration ready. **Blocked on approved pinned snapshot, current goal documents and adapter mapping review.** |
| Five verification profiles | Artifact/identity, data reconstruction, sampled replay, full replay and inference reproduction remain distinct. |
| Tested commands only | No invented commands. Future commands require approval/source/validation/resource metadata; copying only in public mode. |
| Mock inference isolated and labelled | Development-only lazy import; release/settings checks; success/error/timeout/empty/cancel/retry/history/copy behavior. Production bundle scan and browser tests. |
| Future available releases | Development fixture with exact identity/inventory/runtime/parent/report rendering; immutable file-URL builder; synthetic downloads disabled. |
| Accessibility | Labels, focus, skip link, semantic tables/details, keyboard menu, announced data/copy states, mobile wrapping, reduced motion. Actual results and limits in validation report. |
| No untrusted raw HTML | React text rendering; safe protocols; escaped and bounded JSON. |
| No large automatic fetches or private data collection | Only small same-origin metadata; bounded loader; self-hosted fonts; no analytics/account/prompt persistence. |
| Reproducible install/build | Exact versions, lockfile and documented Node floor; verified scripts in validation report. |
| Static-safe base-path routes | Hash routes and relative assets; browser suite uses a non-root static prefix without SPA fallback. |
| Training and trust policy untouched | Entire deliverable confined to frontend/. No live resource or repository action. |
| Handoff | README, tests, screenshots, validation report, proposed PR text and exact remaining inputs. |

This checklist demonstrates the frontend assignment's fixture-backed scope. It does not mark the overall model project complete. Actual project status and inference remain deferred to the maintainer.
41 changes: 41 additions & 0 deletions frontend/PR_HANDOFF.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Proposed PR

**Title:** Add a static evidence explorer and release frontend for OpenVerifiableLLM

## Description

Visitors need to distinguish model provenance, scoped replay reports and model availability. This adds an isolated React/TypeScript/Vite frontend featuring an enhanced design system with an interactive 3D globe, container scroll perspective cards, six responsive views, URL-preserved evidence filters, shareable records, parent/supersession navigation and full-digest copying.

The application uses validated, explicitly synthetic presentation metadata until maintainers supply an approved pinned public snapshot. Invalid/empty/missing metadata cannot become overall success. Verification results remain separate from workflow progress and browser loading. Both current model roles stay unreleased and production generation stays unavailable.

Includes a development-only inference adapter/UI with exact release/settings checks, accessible interaction states, a lockfile, unit/component/browser tests, production mock-exclusion checks, static base-path routing and an integration handoff. No training, verifier, trust policy, signing, progress state, Python dependency or cloud-resource change is included.

## Validation

See VALIDATION_REPORT.md for actual executed checks and screenshots/. Do not claim the upstream Python suite ran; it was not run for this isolated frontend deliverable. The current full upstream checks should be run in the integrating contributor's supported checkout before PR submission, as CONTRIBUTING.md requests.

## Review focus

- Presentation contract and claim/attribution wording.
- Evidence fixtures and preservation of failed/superseded originals.
- Approved public metadata mapping before changing data mode.
- Frontend-only dependency policy and accessibility checks.

## Remaining maintainer inputs

1. Approved small display snapshot, immutable source revision and raw field mappings.
2. Current PROJECT_GOAL.md and goal_state.json context; no mutable operational state should be published wholesale.
3. Final base/chat repositories, immutable revisions, release roots, inventories, sizes, licenses, model cards, parent relation and supported runtime.
4. Approved tested instruction text for each verifier profile, prerequisites, validation evidence and sourced resource measurements/estimates.
5. Supported inference interface, release identity/capabilities, limits, privacy policy and cancellation semantics.
6. Static-host owner/target/base path and any approved branding assets.

## Changed paths

All delivered paths are under frontend/: src/, public/data/, tests/, scripts/, screenshots/, licenses/, package.json/package-lock.json, TypeScript/Vite/Vitest/Playwright configuration and documentation. dist/ is included in the export for preview and is ignored by Git; do not commit it unless the upstream host explicitly requires generated files.

The supplied archive had no frontend. Compare the current upstream tree before integration. Work on a separate branch and preserve others' work. No PR has been opened or submitted by this task.

## AI assistance

Implementation, fixture/test authoring, documentation and Figma design translation were AI-assisted with Codex and the Figma plugin. No human review, maintainer approval or real model verification is claimed. Recheck current contribution policy before submitting.
Loading