mirror of https://github.com/Stirling-Tools/Stirling-PDF.git synced 2026-09-03 05:10:16 +03:00

Files

T

Reece 218a8400ca perf(files): big file lists render only what changed and only what shows

Three compounding costs made a full folder feel sticky:

- Every card and row re-rendered on ANY page state change, because item
  components weren't memoized and got fresh closures each render. Items
  now take a single stable actions dispatcher (latest-ref backed, so
  behavior stays current while identity stays fixed) and are React.memo —
  a selection click re-renders the two cards whose selection changed, not
  all 500. Selection-aware behavior (drag payloads, multi-move) moved
  into the dispatcher so items no longer hold the selection Set, whose
  identity changes on every click.
- Each lazily generated thumbnail updated the shared stub immediately,
  re-rendering every file-list consumer once per thumbnail — hundreds of
  times as a folder fills in. Updates now flush in windows; the card
  itself paints instantly from local state.
- Offscreen cards still paid layout and paint. content-visibility lets
  the browser skip them; the intrinsic size keeps the scrollbar honest.

2026-09-01 16:14:54 +01:00

.claude/agents

playwright (#6025 )

2026-04-27 11:35:50 +01:00

.storybook

deps(frontend): upgrade i18next ecosystem to v26 (#7356 )

2026-08-21 11:32:16 +00:00

editor

perf(files): big file lists render only what changed and only what shows

2026-09-01 16:14:54 +01:00

scripts

Consolidate buttons and related components (#6787 )

2026-07-07 16:06:56 +00:00

shared/components

Consolidate buttons and related components (#6787 )

2026-07-07 16:06:56 +00:00

.gitignore

a11y: empty the grandfathered Storybook baseline (1,058 → 0) (#7309 )

2026-08-12 09:06:05 +00:00

.oxfmtrc.json

Replace Prettier with Oxfmt (#7422 )

2026-08-24 10:34:12 +00:00

oxlint.comments.config.ts

Comment-quality standard, and the gate that enforces it (#7663 )

2026-08-28 10:56:50 +00:00

oxlint.config.ts

Fix any type usages in frontend (#7617 )

2026-08-24 10:33:50 +00:00

package-lock.json

build(deps): bump @tanstack/react-query from 5.101.4 to 5.102.0 in /frontend in the tanstack group across 1 directory (#7749 )

2026-08-31 10:15:11 +01:00

package.json

build(deps): bump @tanstack/react-query from 5.101.4 to 5.102.0 in /frontend in the tanstack group across 1 directory (#7749 )

2026-08-31 10:15:11 +01:00

README.md

Replace Prettier with Oxfmt (#7422 )

2026-08-24 10:34:12 +00:00

stylelint.config.mjs

Replace Prettier with Oxfmt (#7422 )

2026-08-24 10:34:12 +00:00

vitest.config.ts

Replace ESLint and dpdm with Oxlint (#7330 )

2026-08-07 16:02:11 +00:00

README.md

Frontend

All frontend commands are run from the repository root using Task:

task frontend:dev — start Vite dev server (localhost:5173)
task frontend:build — production build
task frontend:test — run tests
task frontend:test:watch — run tests in watch mode
task frontend:lint — run linting
task frontend:typecheck — run TypeScript type checking
task frontend:check — run typecheck + lint + test
task frontend:install — install npm dependencies

For desktop app development, see the Tauri section below.

Layout

frontend/ is a workspace containing one or more apps. Today it holds the PDF editor under frontend/editor/; new apps (the developer portal, etc.) will sit alongside it as siblings. Shared tooling — package.json, node_modules, .storybook/, oxlint, oxfmt — lives at frontend/ so every app installs once and lints with the same config.

Environment Variables

The editor's environment variables live in committed .env files at frontend/editor/:

.env — used by all builds (core, proprietary, and as the base for desktop/SaaS)
.env.desktop — additional vars loaded in desktop (Tauri) mode
.env.saas — additional vars loaded in SaaS mode

These files contain non-secret defaults and are checked into Git, so most dev work needs no further setup.

To override values locally (API keys, machine-specific settings), create an uncommitted sibling editor/.env.local / editor/.env.desktop.local / editor/.env.saas.local. Vite automatically layers these on top of the committed files.

Docker Setup

For Docker deployments and configuration, see the Docker README.

Tauri

All desktop tasks are available via Task. From the root of the repo:

Dev

task desktop:dev

This ensures the JLink runtime and backend JAR exist (skipping if already built), then starts Tauri in dev mode.

Build

task desktop:build

This does a full clean rebuild of the backend JAR and JLink runtime, then builds the Tauri app for production.

Platform-specific dev builds are also available:

task desktop:build:dev           # No bundling
task desktop:build:dev:mac       # macOS .app bundle
task desktop:build:dev:windows   # Windows NSIS installer
task desktop:build:dev:linux     # Linux AppImage

JLink Tasks

You can also run JLink steps individually:

task desktop:jlink          # Build JAR + create JLink runtime
task desktop:jlink:jar      # Build backend JAR only
task desktop:jlink:runtime  # Create JLink custom JRE only
task desktop:jlink:clean    # Remove JLink artifacts

Clean

task desktop:clean

Removes all desktop build artifacts including JLink runtime, bundled JARs, Cargo build, and dist/build directories.