yukta / ui
CLAUDE.md1 starsChanged 20 days agoApache-2.0View on GitHub
native-smoke.yml runs it on the native binary. The report includes: - Line coverage: Which lines were/weren't executed - Branch coverage: Which conditional branches were/weren't taken - Interactive HTML: Click any file to see source code with coverage highlighting - Metrics: Per-file and aggregate coverage statistics Report location: coverage/index.html (generated, git-ignored)
In this repository21 other files it gives its agents.
- architecture/CLAUDE.mdCLAUDE.md
- boot/CLAUDE.mdCLAUDE.md
- build-logic/CLAUDE.mdCLAUDE.md
- .claude/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- cli/CLAUDE.mdCLAUDE.md
- core/CLAUDE.mdCLAUDE.md
- mcp/CLAUDE.mdCLAUDE.md
- messaging/CLAUDE.mdCLAUDE.md
- plugin-api/CLAUDE.mdCLAUDE.md
- plugins/CLAUDE.mdCLAUDE.md
- plus/CLAUDE.mdCLAUDE.md
- web/CLAUDE.mdCLAUDE.md
- ide-index-mcpSkill
- pickupSkill
- playwrightSkill
- testsSkill
- ticketSkill
- yuktaSkill
- yukta-supervisorSkill
- yukta-workflowsSkill
The file
We split this CLAUDE.md into the rules it gives an agent
3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 129
No dynamic reflection, no classloader resource enumeration needed
- Distinctive: line 133
All UI source files include SPDX license headers.
- Very specific: line 180
After changing a controller, refresh openapi.json (yk gradle :boot:test --tests "*OpenApiSnapshotTest" -Pyukta.openapi.update=true), then …
≈ “Common” is an estimate: at least 1 in 5 of the 27,641 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
UI Module CLAUDE.md
Overview
React SPA frontend with Vite, Tailwind CSS v4, and Gradle integration. The ui module produces a static JAR containing the built React application, consumed by the boot module for deployment.
Project Structure
- Root level: Node/Vite/React project files (package.json, vite.config.ts, src/, e2e/, index.html, public/)
- Docs:
../docs/contributing/modules/ui.mdx(module guide); open risks, bugs and review findings: GitHub issues labelledui(gh issue list -l ui; risks also carryrisk); evolution path and quality lenses:../design/assessments/ui.md. The design spec and mockups (docs/design/) referenced below no longer exist build.gradle.kts: Gradle wiring for Vite build → JAR static assetsbuild/: Gradle build output (JAR, reports, etc.)
Build & Development Commands
Development
# Terminal 1: Vite dev server (http://localhost:5173 with HMR)
cd ui && pnpm dev
# Terminal 2: Spring Boot backend (http://localhost:9858)
./gradlew :boot:bootRunProduction Build
# Build the React SPA and create JAR with static assets
yk gradle :ui:buildTesting
# Unit/component tests (Vitest + React Testing Library)
yk gradle :ui:pnpmTest
# E2E tests (Playwright, requires browsers installed)
yk gradle :ui:pnpmTestE2e -PrunE2e=trueE2E against a real server
e2e/real/examples.spec.ts (config playwright.real.config.ts, no MSW) drives the UI of a running server: it creates a session from
every bundled template and runs examples, one with a human answer in the UI. Sessions are named e2e-<template>-<run> and deleted
afterwards, so it repeats on the same server. Start the server as the examples need it (YUKTA_PLUGINS_ENABLED=all,
YUKTA_PROCESS_ALLOWED_COMMANDS=sh,echo,python3; see examples/README.md), then:
YUKTA_URL=http://127.0.0.1:9858 pnpm test:e2e:real # or: release/ui-smoke.sh http://127.0.0.1:9858native-smoke.yml runs it on the native binary.
Test Coverage Reporting
# Generate coverage report and auto-open in browser (line + branch coverage)
pnpm coverage
# Generate coverage without opening (useful for CI/CD)
pnpm exec vitest run --coverageThe report includes:
- Line coverage: Which lines were/weren't executed
- Branch coverage: Which conditional branches were/weren't taken
- Interactive HTML: Click any file to see source code with coverage highlighting
- Metrics: Per-file and aggregate coverage statistics
Report location: coverage/index.html (generated, git-ignored)
Tech Stack
- React 19: UI framework
- Vite 8: Fast dev server and production build (Rolldown; vendor chunks in
vite.config.ts) - React Router 8: Client-side routing (createBrowserRouter, no SSR)
- Tailwind CSS 4: CSS-first
@themedesign tokens (light + dark modes) - TanStack Query 5: Server state & data fetching
- TanStack Table 9: Headless data table logic
- TanStack Virtual: Windowed rendering of the log panel
- shadcn/ui: Copy-in primitives, style
base-rhea. Re-adding one withpnpm dlx shadcn@latest add <name> -oneeds three fixes: thecnimport (@/lib/utils), Material Symbols instead oflucide-react, and the SPDX header - TypeScript strict mode: Type safety
- Vitest + RTL: Unit/component testing
- Playwright: E2E browser testing
- ESLint (flat config) + Prettier: Linting & formatting
- pnpm: Package manager (Gradle-managed Node version via node-conventions)
Architecture
Gradle Integration
pnpmBuildtask: Runspnpm run build(working directory: ui root) → producesdist/processResources: Copiesdist/→build/resources/main/static/→ included in JAR- Static assets served by
bootmodule via Spring's classpath resource handling - SpaWebFluxConfig in boot: Fallback routing (non-existent routes → index.html for SPA)
Frontend Architecture
- Route-based (
routes/router.tsx, all but the session list arelazy):/(redirects to/sessions, keeping the query),/sessions,/sessions/new,/sessions/import,/sessions/:sessionIdand/sessions/:sessionId/edit,/sessions/:sessionId/workflow/:workflowId(run view: graph or timeline,RunControls, node sheet, progress and logs;?exec=picks the run,?node=opens a node),.../workflow/:workflowId/edit(builder),/runs(search across sessions;/historyredirects here),/plugins(catalog),/control(Overview tab: the Mission Control dashboard, then the scheduler, supervisors, workers and control bus tables; Activity tab: live events; Audit tab: control audit) and/showcase/dashboard(dashboard primitives on sample data). A left rail (a bottom bar on phones) links Sessions, Runs, Plugins, Supervisors and Control. The user-facing page list is../docs/interfaces/web-ui.mdx; the client-by-client table is../docs/reference/client-parity.mdx - Builder (
features/builder): form-based, not drag-and-drop.WorkflowEditorPageedits one workflow draft (add node, edges via selects, live canvas preview),NodeInspectorrenders the plugin'sconfigSchemathroughConfigForm(raw JSON editor when a plugin declares none) plus the sharedenginepolicy panel. Save validates withPOST /api/sessions/validate, then sends the whole session (GET /api/sessions/{id}/configkeeps tag values) toPOST /api/sessions - Feature-based folders:
src/features/sessions/{api,components,hooks,types}for scalability - Shared UI:
src/components/ui/(shadcn primitives),src/components/layout/(AppHeader, AppFooter, etc.) - Lib:
src/lib/apiClient.ts(fetchApiwrapper and theapiURL-encoding template tag),src/lib/queryClient.ts,src/lib/theme.ts(dark mode) - Design tokens:
src/index.cssTailwind v4@themeblock
Data Fetching
- REST: TanStack Query for session list, plugin metadata, workflow configs
- SSE:
useEventSourceJsonstreams execution status (GET /api/executions/{executionId}/status/stream?includeHistory=true) and logs (GET /api/sessions/{sessionId}/executions/{executionId}/logs/entries). It reconnects with backoff (1 s to 30 s) while the execution is live; the server replays history, so consumers dedupe - API client unwraps the
ApiResponse<T>envelope and throwsApiErrorcarrying the server'smessageandFieldError[]. Build URLs withapi`/api/sessions/${id}`so IDs are encoded - Server statuses are mapped only in
features/workflow/lib/statusMapper.ts.NODE_*values are node-level, never execution-terminal
Design System
- Tokens:
src/index.css. shadcn presetb27GcrRo(base-rhea: soft, rounded, Inter) sets the structure and shape. The colours come frompublic/logo.svg: blue#2F6BFF(primary), slate#6A7A9B(cool-tinted neutrals) and orange#E85D0C(--attention, used for the running pulse).:root/.darkhold the shadcn variables (oklch); the Material-style names (on-surface,surface-container,outline-variant, ...) are aliases in@theme inline. Success, warning and error keep their own colours - Typography: Inter Variable (
@fontsource-variable/inter), JetBrains Mono for code - Logo and favicons:
public/logo.svgis the source (untouched, it embeds C2PA metadata).pnpm run favicons(needs Inkscape and ImageMagick) regeneratesfavicon.svg(drawing only),favicon.ico,favicon-96x96.png,apple-touch-icon.pngand the manifest PNGs. The header shows/favicon.svg - Icons: Material Symbols Outlined, self-hosted as a subset (
src/assets/material-symbols-subset.woff2, about 11 KB). After adding an icon name anywhere insrc, runpnpm run iconsto regenerate it (needs network). Plugin node HTML may only use icons listed inPLUGIN_ICONSinscripts/subset-icons.mjs.lucide-reactis not used - Corners: the preset's radius scale (
--radius: 0.625rem). Components fromshadcn addare rounded; give custom containersrounded-xl(panels, tables, cards) orrounded-lg(inputs, small controls) and chipsrounded-full - Semantic tokens:
success/warningfor status,terminal/log-*for the logs panel (never hardcode black orneutral-*). Use the named type utilities (text-headline-lgpage titles,text-headline-mdsections,text-body-*,text-label-*,text-code-smfor mono,text-overlinefor panel and table labels, sentence case); rawtext-xs/sm/lgonly size icon glyphs; minimum text size is 12px - Docs theme parity: the app follows the Mintlify docs theme (
docs/style.css); keep the two in step. Elevation isshadow-card(panels, tables, code) andshadow-raised(hover, overlays), never coloured glows. Motion uses one curve,ease-out-soft(transition-standard, 180ms), and the global reduced-motion guard turns it all off (spinners keep turning).live-dotis the running indicator (dot + expanding ring),hero-backdropthe docs hero glow and grid (behind a header only, never behind data).--spacing-header(mt-header) is the fixed header's height cn()and custom utilities:lib/utils.tsregisters the named type and shadow utilities withtailwind-merge. Add any newtext-*/shadow-*utility there, orcnreads it as a colour and drops it next to a colour class. Don't name a utilitybg-*for the same reason- Shared pieces:
PageHeader(one h1 per page, optionaleyebrow),StateMessage(the only loading/empty/error pattern:toneneutral/loading/error, icon tile, retry,compact),CodeBlock(mono JSON with copy),StatusChip(dot + label),Callout(info/success/warning/danger notices;InlineErroris a compact danger one),Card(components/ui/card.tsx,interactivefor clickable cards),TableFrame+Table(components/ui/table.tsx, the one table style),NativeSelectandinputFieldClassName/textareaFieldClassName(components/ui/native-select.tsx) for native fields - Navigation: header items are rounded pills, the current section in
bg-accent; belowsmthey show icons only (the label stays the accessible name). Selected items in side lists (plugins, editor nodes) use the same accent pill - Page motion:
usePageTransitionfades<main>in on route change without remounting the page - Layout: pages are full width (no
max-w-*on<main>); the header, breadcrumb, pages and footer share one gutter (px-4 sm:px-6). Only prose (max-w-prose) and forms (max-w-xl) keep a readable measure. Spacing tokens are--spacing-spacing-*(classpx-spacing-md) so they do not override Tailwind'smax-w-md/w-lgnamed sizes - Plugin categories:
--cat-trigger|processor|terminal(the logo's orange, blue and slate) are used only on the canvas, the plugin catalog and edges (features/workflow/lib/categoryAccent.ts). Node effects (running glow, edge flow, hover, selected ring, graph fade-in) live inindex.cssunder "Workflow canvas" and are disabled byprefers-reduced-motion - Icon names missing from
material-symbols(expand_more,expand_less) are listed inPLUGIN_ICONSinscripts/subset-icons.mjs - Bundle budget:
pnpm run buildfails if a JS chunk is over 300 KB (the lazychartschunk with recharts: 450 KB) or the icon font over 100 KB (scripts/check-bundle-size.js)
Development Workflow
- Frontend dev:
cd ui && pnpm dev(Vite dev server auto-rebuilds, HMR enabled) - Backend dev:
./gradlew :boot:bootRun -x test(proxies/api/**to Spring via vite.config.ts server.proxy) - Tests:
pnpm test(watch mode) orpnpm test:e2e(Playwright against dev server) - Production:
yk gradle :ui:buildwires Vite output into JAR;bootserves it as static resources
Native Image Support
bootmodule includes GraalVM native-image configurationuiJAR static assets (dist/) are copied into classpath resources at build time- SpaWebFluxConfig provides SPA fallback routing (resource resolving is native-image compatible)
- No dynamic reflection, no classloader resource enumeration needed
License Header Management
All UI source files include SPDX license headers. This is managed through a three-layer approach:
1. REUSE.toml (Baseline Compliance)
- FSFE-compliant metadata at repo root
- Defines copyright holder, license, and excludes generated files (dist/, node_modules/)
- Validated by
reuse lint(run via CI/CD)
2. Gradle Task (yk gradle :ui:check)
validateHeaderstask runs on everycheck- Calls
pnpm run lint:headers(Node.js-based glob validation) - Checks all source files match expected SPDX header format
- Fails the build if headers are missing/incorrect
3. Header Templates (config/license/header-js.txt, config/license/header-css.txt)
header-js.txt: For JS/TS source files (double-slash comment syntax)header-css.txt: For CSS source files (block comment syntax)- Used by developers to format headers consistently
Header Format:
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: 2026 Infenia Private LimitedQuick Commands:
# Validate headers locally
pnpm run lint:headers
# Add/fix headers manually to new files
cat config/license/header-js.txt | cat - <newfile> > <newfile>.tmp && mv <newfile>.tmp <newfile>
# Gradle validation (runs on every check)
yk gradle :ui:checkImports
@.claude/rules/coding-standards.md @.claude/rules/git-workflow.md
API types
After changing a controller, refresh openapi.json (yk gradle :boot:test --tests "*OpenApiSnapshotTest" -Pyukta.openapi.update=true), then run pnpm run api:types -- openapi.json. apiTypesCheck fails the ui check when src/types/api.generated.ts is stale.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

