feat(ui): unify gittensory-ui and gittensory-miner-ui on one design system

[JSONbored]

Summary

Extracts the gittensory-ui design system (46 shadcn/Radix components, tokens, utils) into a new shared package, @jsonbored/gittensory-ui-kit, and migrates gittensory-miner-ui onto it — replacing its hand-rolled dark palette and raw Tailwind classes with the same shared components and tokens the main site uses. Also ports gittensory-ui's token-enforcement ESLint rule into miner-ui so a contributor can't silently reintroduce ad hoc colors/spacing.

Closes #4966, Closes #4967.

Changes

Area	Change
packages/gittensory-ui-kit/ (new)	46 components, theme.css, utils.ts, use-mobile hook — copied verbatim from gittensory-ui
apps/gittensory-ui/src/components/ui/*	Converted to 1-line export * shims re-exporting from the shared package
apps/gittensory-ui/src/lib/utils.ts, src/hooks/use-mobile.tsx	Same shim pattern
apps/gittensory-ui/src/styles.css	Imports the shared theme.css; keeps only site-local marketing flourishes (hero glow, grid, gradient border)
apps/gittensory-miner-ui/src/routes/*.tsx	Rebuilt on shared Card/Badge/Table components and design tokens instead of raw border-white/10/text-emerald-300/80-style classes; data-fetching logic unchanged
apps/gittensory-miner-ui/index.html	Hardcoded class="dark" (matches gittensory-ui's current dark-only deployment — no toggle exists on either app yet)
apps/gittensory-miner-ui/eslint.config.js	Added the same no-restricted-syntax token-enforcement rule gittensory-ui already has, scoped to src/routes/**
package-lock.json	miner-ui's vite bumped ^7.3.1 → ^8.1.3 to match gittensory-ui/dedupe the workspace tree

Scope

• The PR title follows type(scope): short summary Conventional Commit format.
• This PR is focused on the design-system unification only — no unrelated backend/API/docs changes.
• Follows CONTRIBUTING.md; no site/, VitePress, or CNAME changes.
• Linked issues (Extract a shared design-system package for gittensory-ui and gittensory-miner-ui #4966, Migrate gittensory-miner-ui onto the shared design system #4967) — both maintainer-only/roadmap, authored and merged by the owner.

Validation

• git diff --check
• npm run actionlint (not run — no workflow changes in this PR)
• npm run ui:typecheck (both apps)
• npm run ui:test (both apps — 169 + 27 = 196/196 passing)
• npm run ui:build (both apps, incl. gittensory-ui's SSR/Cloudflare nitro target)
• npm run ui:lint (both apps — 0 errors)
• npm audit --audit-level=moderate — 0 vulnerabilities
• npm run test:coverage / test:workers / build:mcp / test:mcp-pack / ui:openapi:check — not run locally; this PR touches only apps/** and packages/gittensory-ui-kit/** (no src/**, no API/OpenAPI/wrangler changes), so these are unaffected. CI will confirm.
• Manually verified the token-enforcement lint rule actually fires: temporarily reintroduced a raw Tailwind class in a miner-ui route, confirmed ui:lint failed, reverted.
• Manually verified in a local dev-server preview: all 3 miner-ui routes (Overview/Run history/Portfolio) render the shared dark theme, lime accent, and token typography correctly; command palette/dialog interactions in gittensory-ui still work post-shim; no console errors.

If any required check was skipped, explain why:

• actionlint/test:coverage/test:workers/build:mcp/test:mcp-pack/ui:openapi:check skipped locally because this PR has zero changes under src/**, .github/workflows/**, or any OpenAPI/wrangler surface — only apps/gittensory-ui/**, apps/gittensory-miner-ui/**, and the new packages/gittensory-ui-kit/**. CI runs these regardless and will catch anything I've misjudged.

Safety

• No secrets, wallet details, hotkeys, coldkeys, PATs, private keys, trust scores, or private rankings anywhere.
• Public GitHub text stays sanitized and low-noise.
• N/A — no auth/cookie/CORS/GitHub App/Cloudflare/session changes.
• N/A — no API/OpenAPI/MCP behavior changed.
• miner-ui's three routes use their existing real local-API data-fetching (fetchRunStates, fetchPortfolioQueue) unchanged — no mock/demo fallback introduced.
• UI Evidence screenshots below — verified visually via a local dev-server preview (screenshots shown directly to the maintainer during development) but not uploaded as GitHub-hosted images, since that requires a browser-authenticated drag-and-drop I don't have CLI access to. Neither Extract a shared design-system package for gittensory-ui and gittensory-miner-ui #4966 nor Migrate gittensory-miner-ui onto the shared design system #4967 carries the visual label. Happy to attach if wanted — just say the word and I can walk through it via browser automation, or attach them yourself from the screenshots already shared in this conversation.
• No public docs/changelog changes needed.

UI Evidence

Not embedded as GitHub-hosted images (see Safety note above) — visually verified via local dev-server screenshots + an accessibility-tree snapshot confirming Card/Badge/Table/heading semantics render correctly, already shared with the maintainer directly during this session.

Notes

• #4967 depended on #4966's package existing first; both are included in this single PR since they were always meant to ship together and splitting them would create an unmergeable stacked-branch dependency.
• Both issues are maintainer-only/roadmap — owner-authored, not subject to the contributor one-shot gate.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
❌ Deployment failed View logs	gittensory-ui	df317d4	Jul 11 2026, 06:18 AM

[superagent-security]

Superagent didn't find any vulnerabilities or security issues in this PR.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.27%. Comparing base (c8bb830) to head (eac49b5).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4973   +/-   ##
=======================================
  Coverage   94.27%   94.27%           
=======================================
  Files         451      451           
  Lines       38900    38909    +9     
  Branches    14172    14178    +6     
=======================================
+ Hits        36674    36683    +9     
  Misses       1574     1574           
  Partials      652      652           

Flag	Coverage Δ
shard-1	46.84% <ø> (+0.01%)	⬆️
shard-2	33.32% <ø> (+<0.01%)	⬆️
shard-3	31.41% <ø> (+<0.01%)	⬆️
shard-4	33.16% <ø> (+<0.01%)	⬆️
shard-5	33.54% <ø> (-0.01%)	⬇️
shard-6	45.25% <ø> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 7 files with indirect coverage changes

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[loopover-orb]

Caution

🟥🟥🟥🟥🟥🟥🟥🟥🟥🟥🟥🟥

🛑 Gittensory review result - fixes required

_{Review updated: 2026-07-11 06:27:52 UTC}

111 files · 1 AI reviewer · no blockers · readiness 100/100 · CI failing · blocked

🛑 Suggested Action - Manual Review

Review summary
This PR extracts gittensory-ui's 46 shadcn/Radix components into a new @​jsonbored/gittensory-ui-kit workspace package and migrates gittensory-miner-ui onto it, replacing hand-rolled dark-mode Tailwind classes with shared tokens and adding the same token-enforcement ESLint rule to miner-ui. The bulk of the diff (sidebar.tsx, chart.tsx, theme.css, etc.) is a verbatim copy of already-shipped gittensory-ui code, so correctness risk there is low; the real risk surface is the wiring — the new package's exports map and the app-side shim files aren't shown in full, so subpath resolution for imports like '@​jsonbored/gittensory-ui-kit/components/card' and '/theme.css' can't be confirmed from what's visible here. The PR correctly links and closes #4966/#4967 as the review guide requires.

Nits — 7 non-blocking

• packages/gittensory-ui-kit/package.json wasn't shown in full — confirm its `exports` map actually declares every subpath used by consumers (`/components/card`, `/theme.css`, `/hooks/use-mobile`, etc.), since the whole migration hinges on that resolving correctly and it isn't visible in this diff.
• packages/gittensory-ui-kit/LICENSE adds a fresh AGPLv3 file for an internal workspace package consumed by a Cloudflare Worker deployment — confirm this matches the repo's actual root license and that you've considered AGPL's network source-disclosure clause before shipping it inside a hosted Worker.
• The `vite` bump from `^7.3.1` to `^8.1.3` for gittensory-miner-ui (apps/gittensory-miner-ui/package.json) is an unrelated major-version dependency change bundled into a design-token-unification PR — worth splitting out or explicitly justifying, since major bumps carry their own compatibility risk independent of the token work.
• 101 changed source files add 0 test lines (per the size/ratio data) — even though these are largely copied shadcn primitives, it's worth a one-line note on why no test coverage was needed for the new package.
• apps/gittensory-miner-ui/eslint.config.js scopes the new `no-restricted-syntax` token rule to `src/routes/**` only — confirm that's intentional (vs. also covering any future local `src/lib` or `src/components` files that could reintroduce raw Tailwind classes).
• PR author also opened the linked issue — Link an issue that was opened by a different contributor, or provide a rationale for why this self-authored issue represents genuine discovery work.
• Code changes lack test evidence — Add focused regression tests or explain why existing coverage is sufficient.

CI checks failing

• validate
• validate-code
• Build UI preview artifact
• Workers Builds: gittensory-ui — Workers Builds: gittensory-ui

Signal	Result	Evidence
Code review	✅ No blockers	1 reviewer
Linked issue	✅ Linked	#4966, #4967
Related work	✅ No active overlap found	No same-issue or scoped active PR overlap found.
Change scope	✅ 20/20	Low review scope from cached public metadata (2 linked issues).
Validation posture	✅ 25/25	PR body includes validation/test evidence.
Contributor workload	✅ 10/10	Author activity: 48 registered-repo PR(s), 40 merged, 423 issue(s).
Contributor context	✅ Confirmed Gittensor contributor	JSONbored; Gittensor profile; 48 PR(s), 423 issue(s).
Gate result	✅ Passing	No configured blocker found.
Improvement	⚠️ ℹ️ None detected	risk: low · value: none — No structural-improvement signals were detected for this PR. LLM value judgment: significant — Consolidating two hand-maintained UI stacks onto one shared, token-enforced design-system package is a substantial, well-targeted structural improvement that directly closes two linked issues and eliminates a whole class of drift between the two apps.

Linked issue satisfaction

Addressed
The PR extracts styles.css tokens and the 46 UI primitives into packages/gittensory-ui-kit (verbatim copy per description, including sidebar.tsx shown in the diff), converts gittensory-ui's local ui/, utils.ts, and use-mobile.tsx into shim re-exports of the shared package, and updates styles.css to import the shared theme.css while keeping only site-local decorative styles — matching the issue's e

Review context

• Author: JSONbored
• Role context: owner (maintainer lane)
• Public audience mode: oss maintainer
• Lane context: Repository is configured for direct PR review.
• Public profile languages: not available
• Official Gittensor activity: 48 PR(s), 423 issue(s).
• PR-specific overlap: none found.

Contributor next steps

• Treat this as maintainer-lane context rather than normal contributor-lane activity.

Signal definitions

• Related work = same linked issue, overlapping active PRs, or title/path similarity.
• Change scope = cached public metadata such as size labels, draft state, and review-burden hints.
• Validation posture = whether the PR provides enough public validation/test evidence for maintainer review.
• Contributor workload = public contributor activity and cleanup pressure, not a repo-wide quality failure.
• Contributor context = public GitHub/Gittensor identity context; non-Gittensor status is not a blocker.

Visual preview

Route	Viewport	Before (production)	After (this PR's preview)	Diff
/	desktop			—
/	mobile			—
/portfolio	desktop			—
/portfolio	mobile			—

Click any thumbnail to open the full-size screenshot. Before = production · After = this PR's preview deploy.

_{🟩 Safe / merged · 🟦 Advisory · 🟨 Held for review · 🟥 Blocked / closed}

---

💰 Earn for open-source contributions like this. Gittensor lets GitHub contributors earn for the work they already do — register to start earning →.

Checked by Gittensory, a quiet PR intelligence layer for OSS maintainers.

• Re-run Gittensory review