mirror of
https://github.com/arsvendg/Stirling-PDF.git
synced 2026-07-14 10:34:06 +02:00
919f0ade99
# Description of Changes ## What & why This PR introduces the **Stirling developer portal** — a new control-plane frontend that sits alongside the existing PDF editor — plus the shared design system and workspace structure needed to host both apps in one frontend. The portal is the parent product surface: where users connect sources, compose pipelines, wire agents, and manage usage / billing / infrastructure, with the PDF editor as one capability inside it. This PR lays the **foundation** — workspace reshape, design system, app shell, navigation, and a mock-driven home — rather than wiring real backends (those surfaces are placeholders for follow-up phases). ## What's in this PR **1. Frontend repo reshape (`frontend/src/` → `frontend/editor/`)** The existing editor app moved under `frontend/editor/`, so `editor`, `portal`, and `shared` are siblings in one workspace. All references were updated accordingly: `LICENSE`, `.dockerignore`, `.gitignore`, build/sign shell scripts, the GH language-check script, the Taskfile, and Docker config. **No editor source logic changed — path references only.** **2. New shared design system (`frontend/shared/`)** - **Design tokens** in `tokens.css` as the single runtime source of truth (light/dark, category accents, gradients). `tokens.ts` now holds only the `Tier` type — the old JS palette mirror was removed (nothing consumed it and it had drifted). - ~30 framework-light **components** (Card, Button, Input, Select, Tabs, Modal, Drawer, Toast, MetricCard, StatusBadge, Skeleton, EmptyState, …) with Storybook stories. - **Typed data catalogues**: `endpoints.ts` (10 verticals / 64 endpoints) and `ops.ts`. **3. New developer portal app (`frontend/portal/`)** - App shell: `Header`, `Sidebar`, `AssistantPanel`, search modal, notifications, tier switcher, theme toggle, MSW toggle. - **Tier-aware** home (free / pay-as-you-go / enterprise): KPI strip, 30-day usage chart, onboarding checklist, quick actions, recent activity, region health, product grid, and a curated **"Popular use cases"** teaser. - **Documents** view hosting the full, tab-filterable endpoint catalogue. - Placeholder views for Sources / Pipelines / Agents / Editor / Infrastructure / Usage & Billing / Developer Docs / Settings (follow-up phases). - **MSW-mocked** API layer: `api/*` issues real `fetch`, intercepted by mocks in dev/Storybook; pointing at a real backend is just a matter of not registering MSW. `react-router` URLs; Tier / View / UI contexts. **4. Tooling & guardrails** - ESLint extended to `portal` + `shared`, with **layering-boundary rules**: `shared/` may depend only on third-party packages and itself (no `@app` / `@portal` / `@core` / `@proprietary` / Tauri), so it stays cleanly extractable into a standalone package later. - `dpdm` circular-dependency check now walks editor + portal + shared (the old glob matched only 2 files). - New **devDependencies only** — Storybook (+ a11y/docs/themes addons), MSW. No runtime dependencies added. - New tasks: `frontend:dev:portal`, `frontend:build:portal`. ## Testing done locally - `tsc` for both `portal` and `shared` projects — clean - `eslint --max-warnings=0` across the whole frontend — clean - `dpdm` circular-dependency check — no cycles - Editor builds clean: `vite build editor --mode core` (✓ built, only the pre-existing >500 kB chunk-size advisory) - Editor runs in dev (core mode) with **zero console errors**; portal runs in dev across all three tiers ## Notes for reviewers - The change is overwhelmingly **additive**: `shared/` and `portal/` are brand-new; the existing editor is path-reference changes only. - The portal is intentionally **mock-driven** at this stage — real backends and the remaining views land in follow-up phases. --- ## Checklist ### General - [ ] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [ ] I have read the [Stirling-PDF Developer Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/DeveloperGuide.md) (if applicable) - [ ] I have read the [How to add new languages to Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md) (if applicable) - [x] I have performed a self-review of my own code - [x] My changes generate no new warnings ### Documentation - [ ] I have updated relevant docs on [Stirling-PDF's doc repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/) (if functionality has heavily changed) - [ ] I have read the section [Add New Translation Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags) (for new translation tags only) ### Translations (if applicable) - [ ] I ran [`scripts/counter_translation.py`](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/docs/counter_translation.md) ### UI Changes (if applicable) - [ ] Screenshots or videos demonstrating the UI changes are attached (e.g., as comments or direct attachments in the PR) ### Testing (if applicable) - [ ] I have run `task check` to verify linters, typechecks, and tests pass - [x] I have tested my changes locally. Refer to the [Testing Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/DeveloperGuide.md#7-testing) for more details. --------- Co-authored-by: Claude Opus 4.8 (1M context) <[email protected]>
420 lines
11 KiB
CSS
420 lines
11 KiB
CSS
/*
|
|
* Stirling design tokens — CSS custom properties.
|
|
*
|
|
* This is the single source of truth for the design tokens. Components
|
|
* reference them via var(--color-...); there is no JS palette to keep in sync.
|
|
* Theme switching flips `data-theme="dark"` on <html> and these variables
|
|
* cascade. (tokens.ts holds only the Tier type, not the palette.)
|
|
*
|
|
* Category accents (insurance, finance, legal, …) are not theme-switched —
|
|
* the document types they label are stable, theme-agnostic concepts.
|
|
*/
|
|
|
|
:root,
|
|
[data-theme="light"] {
|
|
/* Text hierarchy */
|
|
--color-text-1: #0f172a;
|
|
--color-text-2: #1a202c;
|
|
--color-text-3: #475569;
|
|
--color-text-4: #64748b;
|
|
/* text-5 was #94a3b8 (≈2.85:1 on white — fails WCAG AA). Bumped to #64748b
|
|
so meta/timestamp copy at small sizes still passes contrast. The visual
|
|
hierarchy now collapses text-4 and text-5 into the same shade — use weight
|
|
or size to differentiate in components instead. */
|
|
--color-text-5: #64748b;
|
|
--color-text-6: #6b7280;
|
|
--color-text-muted: #8b92a1;
|
|
--color-text-placeholder: #9ca3af;
|
|
|
|
/* Body text colour for use on coloured / gradient backgrounds (blue buttons,
|
|
assistant header, onboarding "done" badges). Theme-stable: even in dark
|
|
mode the underlying surface is the brand gradient, so the text is white. */
|
|
--color-text-on-accent: #ffffff;
|
|
|
|
/* Brand / status */
|
|
--color-blue: #3b82f6;
|
|
--color-blue-dark: #2563eb;
|
|
--color-blue-light: #eff6ff;
|
|
--color-blue-border: #bfdbfe;
|
|
--color-purple: #8b5cf6;
|
|
--color-purple-light: #f5f3ff;
|
|
--color-purple-border: #ddd6fe;
|
|
--color-purple-dark: #7c3aed;
|
|
--color-green: #10b981;
|
|
--color-green-light: #ecfdf5;
|
|
--color-green-border: #a7f3d0;
|
|
--color-green-dark: #16a34a;
|
|
--color-red: #ef4444;
|
|
--color-red-light: #fee2e2;
|
|
--color-red-border: #fecaca;
|
|
--color-red-dark: #dc2626;
|
|
--color-amber: #f59e0b;
|
|
--color-amber-light: #fef3c7;
|
|
--color-amber-border: #fde68a;
|
|
--color-amber-dark: #92400e;
|
|
|
|
/* Category accents (theme-stable) */
|
|
--color-cat-insurance: #0ea5e9;
|
|
--color-cat-compliance: #6366f1;
|
|
--color-cat-finance: #10b981;
|
|
--color-cat-legal: #3b82f6;
|
|
--color-cat-healthcare: #8b5cf6;
|
|
--color-cat-government: #dc2626;
|
|
--color-cat-operations: #ec4899;
|
|
--color-cat-hr: #f59e0b;
|
|
--color-cat-realestate: #84cc16;
|
|
--color-cat-energy: #f97316;
|
|
--color-cat-extraction: #14b8a6;
|
|
|
|
/* Surfaces */
|
|
--color-bg: #f8f9fb;
|
|
--color-bg-alt: #f6f8fa;
|
|
--color-surface: #ffffff;
|
|
--color-surface-alt: #ffffff;
|
|
--color-border: #e3e8ee;
|
|
--color-border-light: #eef0f2;
|
|
--color-border-input: #e2e8f0;
|
|
--color-border-hover: #cbd5e1;
|
|
--color-divider: #f0f0f0;
|
|
--color-bg-subtle: #f9fafb;
|
|
--color-bg-hover: #f8fafc;
|
|
--color-bg-muted: #f3f4f6;
|
|
--color-bg-code: #f1f5f9;
|
|
|
|
/* Dropdowns / tooltips */
|
|
--color-dropdown-bg: #ffffff;
|
|
--color-dropdown-border: #e5e7eb;
|
|
--color-dropdown-hover: #f9fafb;
|
|
--color-tooltip-bg: #1e293b;
|
|
--color-tooltip-text: #f8fafc;
|
|
|
|
/* Navigation */
|
|
--color-nav-active: #eff6ff;
|
|
--color-nav-active-text: #3b82f6;
|
|
--color-nav-text: #4b5563;
|
|
--color-nav-hover: #f6f8fa;
|
|
--color-nav-hover-text: #1a202c;
|
|
--color-section-label: #9ca3af;
|
|
--color-logo-text: #111827;
|
|
|
|
/* Header */
|
|
--color-header-bg: #ffffff;
|
|
--color-header-border: #f0f0f0;
|
|
--color-header-text: #111827;
|
|
--color-search-bg: #f9fafb;
|
|
--color-search-border: #e5e7eb;
|
|
--color-search-border-hover: #d1d5db;
|
|
--color-search-text: #9ca3af;
|
|
|
|
/* Sidebar */
|
|
--color-sidebar-bg: #ffffff;
|
|
--color-sidebar-border: #e5e7eb;
|
|
--color-sidebar-divider: #f0f0f0;
|
|
--color-usage-text: #6b7280;
|
|
--color-usage-value: #374151;
|
|
--color-usage-track: #f3f4f6;
|
|
|
|
--color-toggle-off: #cbd5e1;
|
|
--color-badge-red: #ef4444;
|
|
|
|
/* Shadows */
|
|
--shadow-sm: inset 0 0 0 1px #e3e8ee;
|
|
--shadow-md: inset 0 0 0 1px #e3e8ee, 0 1px 2px rgba(15, 23, 42, 0.04);
|
|
--shadow-lg: inset 0 0 0 1px #e3e8ee, 0 4px 12px rgba(15, 23, 42, 0.06);
|
|
--shadow-blue:
|
|
0 1px 2px rgba(59, 130, 246, 0.25), inset 0 1px 0 rgba(255, 255, 255, 0.2);
|
|
--shadow-blue-hover:
|
|
0 2px 6px rgba(59, 130, 246, 0.3), inset 0 1px 0 rgba(255, 255, 255, 0.25);
|
|
|
|
/* Gradients */
|
|
--grad-blue-btn: linear-gradient(
|
|
180deg,
|
|
#5b9bf7 0%,
|
|
#4c8bf5 50%,
|
|
#3a7be8 100%
|
|
);
|
|
--grad-purple-btn: linear-gradient(
|
|
180deg,
|
|
#a78bfa 0%,
|
|
#8b5cf6 50%,
|
|
#7c3aed 100%
|
|
);
|
|
--grad-green-btn: linear-gradient(
|
|
180deg,
|
|
#34d399 0%,
|
|
#10b981 50%,
|
|
#059669 100%
|
|
);
|
|
--grad-amber-btn: linear-gradient(
|
|
180deg,
|
|
#fbbf24 0%,
|
|
#f59e0b 50%,
|
|
#d97706 100%
|
|
);
|
|
--grad-red-btn: linear-gradient(
|
|
180deg,
|
|
#f87171 0%,
|
|
#ef4444 50%,
|
|
#dc2626 100%
|
|
);
|
|
--grad-banner: linear-gradient(135deg, #eef2ff 0%, #ddd6fe 50%, #fce7f3 100%);
|
|
}
|
|
|
|
[data-theme="dark"] {
|
|
--color-text-1: #f1f5f9;
|
|
--color-text-2: #e2e8f0;
|
|
--color-text-3: #94a3b8;
|
|
--color-text-4: #64748b;
|
|
/* Bumped from #475569 (fails AA) — see light-theme note. */
|
|
--color-text-5: #7c869a;
|
|
--color-text-6: #94a3b8;
|
|
--color-text-muted: #64748b;
|
|
--color-text-placeholder: #475569;
|
|
|
|
--color-blue: #60a5fa;
|
|
--color-blue-dark: #3b82f6;
|
|
--color-blue-light: #1e293b;
|
|
--color-blue-border: #1e3a5f;
|
|
--color-purple: #a78bfa;
|
|
--color-purple-light: #1e1b2e;
|
|
--color-purple-border: #2e2650;
|
|
--color-purple-dark: #8b5cf6;
|
|
--color-green: #34d399;
|
|
--color-green-light: #0d2818;
|
|
--color-green-border: #065f46;
|
|
--color-green-dark: #22c55e;
|
|
--color-red: #f87171;
|
|
--color-red-light: #2d1215;
|
|
--color-red-border: #7f1d1d;
|
|
--color-red-dark: #ef4444;
|
|
--color-amber: #fbbf24;
|
|
--color-amber-light: #2d2006;
|
|
--color-amber-border: #78350f;
|
|
/* Deeper than the base so it stays distinct (hover shade + amber text on
|
|
dark surfaces). ~7.4:1 on --color-amber-light, passes WCAG AA. Was
|
|
#fbbf24 — identical to the base — which left Mantine's amber hover a
|
|
no-op in dark mode. */
|
|
--color-amber-dark: #f59e0b;
|
|
|
|
--color-bg: #090c14;
|
|
--color-bg-alt: #0d1120;
|
|
--color-surface: #151c2e;
|
|
--color-surface-alt: #1c2640;
|
|
--color-border: #283248;
|
|
--color-border-light: #1e2840;
|
|
--color-border-input: #2e3c55;
|
|
--color-border-hover: #3d4f6a;
|
|
--color-divider: #1e2840;
|
|
--color-bg-subtle: #111827;
|
|
--color-bg-hover: #1c2640;
|
|
--color-bg-muted: #243044;
|
|
--color-bg-code: #0b0f1a;
|
|
|
|
--color-dropdown-bg: #151c2e;
|
|
--color-dropdown-border: #2e3c55;
|
|
--color-dropdown-hover: #1c2640;
|
|
--color-tooltip-bg: #e2e8f0;
|
|
--color-tooltip-text: #0f172a;
|
|
|
|
--color-nav-active: #172044;
|
|
--color-nav-active-text: #60a5fa;
|
|
--color-nav-text: #94a3b8;
|
|
--color-nav-hover: #1c2640;
|
|
--color-nav-hover-text: #e2e8f0;
|
|
--color-section-label: #475569;
|
|
--color-logo-text: #f1f5f9;
|
|
|
|
--color-header-bg: #0d1120;
|
|
--color-header-border: #1e2840;
|
|
--color-header-text: #f1f5f9;
|
|
--color-search-bg: #151c2e;
|
|
--color-search-border: #2e3c55;
|
|
--color-search-border-hover: #3d4f6a;
|
|
--color-search-text: #64748b;
|
|
|
|
--color-sidebar-bg: #0d1120;
|
|
--color-sidebar-border: #1e2840;
|
|
--color-sidebar-divider: #1e2840;
|
|
--color-usage-text: #64748b;
|
|
--color-usage-value: #94a3b8;
|
|
--color-usage-track: #1e2840;
|
|
|
|
--color-toggle-off: #3d4f6a;
|
|
|
|
--shadow-sm: inset 0 0 0 1px #283248;
|
|
--shadow-md: inset 0 0 0 1px #283248, 0 1px 3px rgba(0, 0, 0, 0.3);
|
|
--shadow-lg: inset 0 0 0 1px #283248, 0 8px 24px rgba(0, 0, 0, 0.4);
|
|
--shadow-blue:
|
|
0 1px 3px rgba(59, 130, 246, 0.35), inset 0 1px 0 rgba(255, 255, 255, 0.1);
|
|
--shadow-blue-hover:
|
|
0 2px 8px rgba(59, 130, 246, 0.45), inset 0 1px 0 rgba(255, 255, 255, 0.15);
|
|
|
|
--grad-blue-btn: linear-gradient(
|
|
180deg,
|
|
#3b82f6 0%,
|
|
#2563eb 50%,
|
|
#1d4ed8 100%
|
|
);
|
|
--grad-banner: linear-gradient(135deg, #0f172a 0%, #111827 50%, #1a1535 100%);
|
|
}
|
|
|
|
/* Always-dark code palette. Not theme-switched. */
|
|
:root {
|
|
--code-bg: #0f172a;
|
|
--code-bg-alt: #1e293b;
|
|
--code-bg-header: #1a2332;
|
|
--code-text: #e2e8f0;
|
|
--code-dim: #64748b;
|
|
--code-muted: #94a3b8;
|
|
--code-keyword: #60a5fa;
|
|
--code-string: #fbbf24;
|
|
--code-number: #c084fc;
|
|
--code-fn: #34d399;
|
|
--code-type: #f472b6;
|
|
--code-property: #93c5fd;
|
|
--code-comment: #475569;
|
|
--code-border: #1e293b;
|
|
/* Window-chrome traffic-light dots in the code-block header. */
|
|
--code-dot: #475569;
|
|
}
|
|
|
|
/* Radii / typography / motion / spacing / z-index — theme-stable */
|
|
:root {
|
|
--radius-xs: 0.1875rem;
|
|
--radius-sm: 0.25rem;
|
|
--radius-md: 0.375rem;
|
|
--radius-lg: 0.5rem;
|
|
--radius-xl: 0.75rem;
|
|
--radius-pill: 0.625rem;
|
|
|
|
--font-sans:
|
|
"Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial,
|
|
sans-serif;
|
|
--font-mono:
|
|
"SF Mono", "Fira Code", Menlo, Consolas, "DejaVu Sans Mono", monospace;
|
|
--font-brand: "Alumni Sans", "Inter", sans-serif;
|
|
|
|
--motion-fast: 0.15s ease;
|
|
--motion-base: 0.2s cubic-bezier(0.4, 0, 0.2, 1);
|
|
--motion-slow: 0.3s ease;
|
|
--motion-enter: 0.22s cubic-bezier(0.4, 0, 0.2, 1);
|
|
|
|
/* 4-px grid spacing scale (rem so it tracks font-size changes). Use these
|
|
in layout primitives + component CSS instead of bare 0.5rem / 0.75rem. */
|
|
--space-0: 0;
|
|
--space-0_5: 0.125rem;
|
|
--space-1: 0.25rem;
|
|
--space-1_5: 0.375rem;
|
|
--space-2: 0.5rem;
|
|
--space-3: 0.75rem;
|
|
--space-4: 1rem;
|
|
--space-5: 1.25rem;
|
|
--space-6: 1.5rem;
|
|
--space-8: 2rem;
|
|
--space-10: 2.5rem;
|
|
--space-12: 3rem;
|
|
|
|
/* Z-index hierarchy. Pick the highest tier that still puts you below the
|
|
thing that's supposed to win. Modals beat drawers beat dropdowns. */
|
|
--z-base: 0;
|
|
--z-sticky: 10;
|
|
--z-dropdown: 25;
|
|
--z-fixed-overlay: 35;
|
|
--z-drawer: 50;
|
|
--z-modal: 100;
|
|
--z-toast: 200;
|
|
}
|
|
|
|
/* Keyframes used across the app. */
|
|
@keyframes fadeInUp {
|
|
from {
|
|
opacity: 0;
|
|
transform: translateY(0.375rem);
|
|
}
|
|
to {
|
|
opacity: 1;
|
|
transform: translateY(0);
|
|
}
|
|
}
|
|
@keyframes fadeIn {
|
|
from {
|
|
opacity: 0;
|
|
}
|
|
to {
|
|
opacity: 1;
|
|
}
|
|
}
|
|
@keyframes scaleIn {
|
|
from {
|
|
opacity: 0;
|
|
transform: scale(0.97);
|
|
}
|
|
to {
|
|
opacity: 1;
|
|
transform: scale(1);
|
|
}
|
|
}
|
|
@keyframes slideInRight {
|
|
from {
|
|
transform: translateX(100%);
|
|
}
|
|
to {
|
|
transform: translateX(0);
|
|
}
|
|
}
|
|
@keyframes pulse {
|
|
0%,
|
|
100% {
|
|
opacity: 1;
|
|
}
|
|
50% {
|
|
opacity: 0.5;
|
|
}
|
|
}
|
|
@keyframes pulseRing {
|
|
0% {
|
|
transform: scale(0.8);
|
|
opacity: 1;
|
|
}
|
|
100% {
|
|
transform: scale(2.2);
|
|
opacity: 0;
|
|
}
|
|
}
|
|
@keyframes spin {
|
|
to {
|
|
transform: rotate(360deg);
|
|
}
|
|
}
|
|
@keyframes shimmer {
|
|
0% {
|
|
background-position: -200% 0;
|
|
}
|
|
100% {
|
|
background-position: 200% 0;
|
|
}
|
|
}
|
|
|
|
@media (prefers-reduced-motion: reduce) {
|
|
*,
|
|
*::before,
|
|
*::after {
|
|
animation-duration: 0.001ms !important;
|
|
animation-iteration-count: 1 !important;
|
|
transition-duration: 0.001ms !important;
|
|
}
|
|
}
|
|
|
|
/* Visually-hidden utility for content meant only for screen readers. */
|
|
.sr-only {
|
|
position: absolute;
|
|
width: 1px;
|
|
height: 1px;
|
|
padding: 0;
|
|
margin: -1px;
|
|
overflow: hidden;
|
|
clip: rect(0, 0, 0, 0);
|
|
white-space: nowrap;
|
|
border: 0;
|
|
}
|