Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
4 changes: 4 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,10 @@ jobs:
librsvg2-dev \
patchelf

# Tauri build.rs requires the host externalBin sidecar to exist.
- name: Fetch FFmpeg sidecar
run: ./scripts/fetch-ffmpeg.sh x86_64-unknown-linux-gnu

- name: Test
working-directory: src-tauri
run: cargo test
Expand Down
8 changes: 8 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -43,16 +43,20 @@ jobs:
- name: macOS (arm64)
platform: macos-latest
rust-targets: aarch64-apple-darwin
ffmpeg-triple: aarch64-apple-darwin
args: "--target aarch64-apple-darwin"
- name: macOS (x86_64)
platform: macos-latest
rust-targets: x86_64-apple-darwin
ffmpeg-triple: x86_64-apple-darwin
args: "--target x86_64-apple-darwin"
- name: Linux (x86_64)
platform: ubuntu-22.04
ffmpeg-triple: x86_64-unknown-linux-gnu
args: "--bundles appimage,deb"
- name: Windows (x86_64)
platform: windows-latest
ffmpeg-triple: x86_64-pc-windows-msvc
args: "--bundles nsis"

steps:
Expand Down Expand Up @@ -97,6 +101,10 @@ jobs:
- name: Install frontend dependencies
run: pnpm install --frozen-lockfile

- name: Fetch FFmpeg sidecar
shell: bash
run: ./scripts/fetch-ffmpeg.sh "${{ matrix.ffmpeg-triple }}"

- uses: tauri-apps/tauri-action@v1
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Expand Down
9 changes: 0 additions & 9 deletions .hallmark/log.json

This file was deleted.

166 changes: 166 additions & 0 deletions .impeccable/design.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,166 @@
{
"schemaVersion": 2,
"generatedAt": "2026-11-03T08:00:00.000Z",
"title": "Design System: PictoolsApp",
"extensions": {
"colorMeta": {
"primary": {
"role": "primary",
"displayName": "Workbench Violet",
"canonical": "oklch(59.01% 0.19675 278.523)",
"tonalRamp": [
"oklch(25% 0.12 278.523)",
"oklch(35% 0.15 278.523)",
"oklch(45% 0.18 278.523)",
"oklch(59.01% 0.19675 278.523)",
"oklch(70% 0.14 278.523)",
"oklch(80% 0.08 278.523)",
"oklch(90% 0.04 278.523)",
"oklch(96% 0.015 278.523)"
]
},
"secondary": {
"role": "secondary",
"displayName": "Done Mint",
"canonical": "oklch(78.158% 0.14381 171.311)",
"tonalRamp": [
"oklch(30% 0.08 171.311)",
"oklch(42% 0.1 171.311)",
"oklch(55% 0.12 171.311)",
"oklch(65% 0.13 171.311)",
"oklch(78.158% 0.14381 171.311)",
"oklch(85% 0.1 171.311)",
"oklch(92% 0.05 171.311)",
"oklch(97% 0.02 171.311)"
]
},
"background": {
"role": "neutral",
"displayName": "Cool Paper",
"canonical": "oklch(98.511% 0.00011 271.152)",
"tonalRamp": [
"oklch(18% 0.002 286.055)",
"oklch(30% 0.002 286.055)",
"oklch(50% 0.01 278.523)",
"oklch(70% 0.005 278.523)",
"oklch(88% 0.005 278.523)",
"oklch(93% 0.00025 271.152)",
"oklch(96.5% 0.00015 271.152)",
"oklch(98.511% 0.00011 271.152)"
]
}
},
"typographyMeta": {
"title": { "displayName": "Title", "purpose": "Tool page titles." },
"body": { "displayName": "Body", "purpose": "Supporting copy and dock summaries." },
"label": { "displayName": "Section label", "purpose": "Uppercase tracking labels above controls." },
"mono": { "displayName": "Mono", "purpose": "Sizes, versions, percents." }
},
"shadows": [],
"motion": [
{
"name": "page-enter",
"value": "opacity + 10px translate, 250ms cubic-bezier(0.16, 1, 0.3, 1)",
"purpose": "Page mount entrance via .page-enter."
},
{
"name": "interactive",
"value": "color/opacity 150–200ms",
"purpose": "Default interactive transitions."
},
{
"name": "cta-lift",
"value": "translateY(-1.5px) on hover; translateY(1px) on press",
"purpose": "Primary CTA press feedback; opacity-only under reduced motion."
}
],
"breakpoints": []
},
"components": [
{
"name": "Primary Button",
"kind": "button",
"refersTo": "button-primary",
"description": "Verb-led filled CTA for run actions.",
"html": "<button class=\"ds-btn-primary\">Convert</button>",
"css": ".ds-btn-primary { background: var(--primary); color: var(--primary-foreground); border: none; border-radius: var(--radius); padding: 0.5rem 1rem; font-size: 0.875rem; font-weight: 500; cursor: pointer; transition: transform 150ms ease, opacity 150ms ease; } .ds-btn-primary:hover { transform: translateY(-1.5px); } .ds-btn-primary:active { transform: translateY(1px); } .ds-btn-primary:focus-visible { outline: 2px solid var(--ring); outline-offset: 2px; } .ds-btn-primary:disabled { opacity: 0.5; cursor: not-allowed; transform: none; }"
},
{
"name": "Secondary Button",
"kind": "button",
"refersTo": "button-secondary",
"description": "Outline secondary actions such as Open folder or Advanced.",
"html": "<button class=\"ds-btn-secondary\">Open folder</button>",
"css": ".ds-btn-secondary { background: transparent; color: var(--muted-foreground); border: 1px solid var(--border); border-radius: var(--radius); padding: 0.5rem 1rem; font-size: 0.875rem; font-weight: 500; cursor: pointer; transition: color 150ms ease, background 150ms ease; } .ds-btn-secondary:hover { color: var(--foreground); background: var(--muted); } .ds-btn-secondary:focus-visible { outline: 2px solid var(--ring); outline-offset: 2px; }"
},
{
"name": "Format Chip On",
"kind": "chip",
"refersTo": "format-chip-on",
"description": "Selected format or preset chip.",
"html": "<button class=\"ds-chip-on\" type=\"button\">WebP</button>",
"css": ".ds-chip-on { background: var(--primary); color: var(--primary-foreground); border: none; border-radius: calc(var(--radius) - 2px); padding: 0.375rem 0.625rem; font-size: 0.75rem; font-weight: 500; cursor: pointer; } .ds-chip-on:focus-visible { outline: 2px solid var(--ring); outline-offset: 2px; }"
},
{
"name": "Format Chip Off",
"kind": "chip",
"refersTo": "format-chip-off",
"description": "Idle format or preset chip.",
"html": "<button class=\"ds-chip-off\" type=\"button\">PNG</button>",
"css": ".ds-chip-off { background: var(--background); color: var(--muted-foreground); border: 1px solid color-mix(in oklch, var(--border) 60%, transparent); border-radius: calc(var(--radius) - 2px); padding: 0.375rem 0.625rem; font-size: 0.75rem; font-weight: 500; cursor: pointer; transition: background 150ms ease, color 150ms ease; } .ds-chip-off:hover { background: var(--accent); color: var(--accent-foreground); } .ds-chip-off:focus-visible { outline: 2px solid var(--ring); outline-offset: 2px; }"
},
{
"name": "Settings Card",
"kind": "card",
"refersTo": "card",
"description": "Bordered content card for Settings.",
"html": "<div class=\"ds-card\"><h3 class=\"ds-card-title\">Language</h3><p class=\"ds-card-body\">Choose the interface language.</p></div>",
"css": ".ds-card { background: var(--card); color: var(--card-foreground); border: 1px solid var(--border); border-radius: var(--radius); padding: 1rem 1.25rem; } .ds-card-title { margin: 0 0 0.25rem; font-size: 0.875rem; font-weight: 600; } .ds-card-body { margin: 0; font-size: 0.75rem; color: var(--muted-foreground); }"
}
],
"narrative": {
"northStar": "The Quiet Workbench",
"overview": "PictoolsApp is an operate surface where the media is the page. Empty tools are a full-canvas drop zone; loaded tools are stage + plan dock + horizontal filmstrip. Chrome stays thin and calm. Accent is rare; success is silent.",
"keyCharacteristics": [
"Stage + filmstrip macrostructure",
"System UI type only",
"Violet primary used sparingly; mint for done only",
"Flat tonal surfaces",
"Verb-led CTAs and segmented chips"
],
"rules": [
{
"name": "The One Voice Rule",
"body": "Primary accent appears on ≤ ~5% of the viewport; rarity is the signal.",
"section": "colors"
},
{
"name": "The Mint Is Done Rule",
"body": "Secondary mint is reserved for success/done states only.",
"section": "colors"
},
{
"name": "The Flat-By-Default Rule",
"body": "Surfaces rest flat. Motion and tint carry state, not drop shadows.",
"section": "elevation"
},
{
"name": "The System Stack Rule",
"body": "Do not add display webfonts to tool pages.",
"section": "typography"
}
],
"dos": [
"Keep tool pages stage-first with filmstrip + dock",
"Use silent success (check + size delta)",
"Preserve source files; force a suffix on path collision",
"Extend this system when adding tools"
],
"donts": [
"Invent a second palette or loud enrichment on app pages",
"Add celebratory toasts on success",
"Restyle Home or Sidebar opportunistically",
"Overwrite source media"
]
}
}
171 changes: 171 additions & 0 deletions DESIGN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,171 @@
---
name: PictoolsApp
description: Local-first media toolbox — calm operate UI, stage-first tools
colors:
background: "oklch(98.511% 0.00011 271.152)"
foreground: "oklch(21.82% 0.00195 286.055)"
card: "oklch(96.5% 0.00015 271.152)"
primary: "oklch(59.01% 0.19675 278.523)"
primary-foreground: "oklch(98% 0 0)"
secondary: "oklch(78.158% 0.14381 171.311)"
muted: "oklch(93% 0.00025 271.152)"
muted-foreground: "oklch(50% 0.01 278.523)"
accent: "oklch(90% 0.04 278.523)"
destructive: "oklch(0.577 0.245 27.325)"
border: "oklch(88% 0.005 278.523)"
ring: "oklch(59.01% 0.19675 278.523)"
typography:
title:
fontFamily: "ui-sans-serif, system-ui, sans-serif"
fontSize: "1.125rem"
fontWeight: 600
letterSpacing: "-0.025em"
body:
fontFamily: "ui-sans-serif, system-ui, sans-serif"
fontSize: "0.875rem"
fontWeight: 400
label:
fontFamily: "ui-sans-serif, system-ui, sans-serif"
fontSize: "0.75rem"
fontWeight: 500
letterSpacing: "0.1em"
mono:
fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace"
fontSize: "0.75rem"
fontWeight: 400
rounded:
sm: "calc(0.625rem - 4px)"
md: "calc(0.625rem - 2px)"
lg: "0.625rem"
spacing:
header-x: "1.25rem"
header-y: "0.75rem"
dock-x: "1.25rem"
dock-y: "0.75rem"
filmstrip-thumb: "6rem"
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.primary-foreground}"
rounded: "{rounded.lg}"
padding: "0.5rem 1rem"
button-secondary:
backgroundColor: "transparent"
textColor: "{colors.muted-foreground}"
rounded: "{rounded.lg}"
padding: "0.5rem 1rem"
format-chip-on:
backgroundColor: "{colors.primary}"
textColor: "{colors.primary-foreground}"
rounded: "{rounded.md}"
padding: "0.375rem 0.625rem"
format-chip-off:
backgroundColor: "{colors.background}"
textColor: "{colors.muted-foreground}"
rounded: "{rounded.md}"
padding: "0.375rem 0.625rem"
---

# Design System: PictoolsApp

## Overview

**Creative North Star: "The Quiet Workbench"**

PictoolsApp is an operate surface, not a marketing spectacle. The media is the page: empty tools are a full-canvas drop zone; loaded tools are stage + plan dock + horizontal filmstrip. Chrome stays thin, utilitarian, and calm so attention stays on the file being processed.

Personality is modern-minimal and restrained. Accent color is rare. Success is silent (check + size delta), never celebratory. Home keeps its centered wordmark; tool pages must not invent enrichment, second palettes, or dashboard chrome.

**Key Characteristics:**
- Stage + filmstrip macrostructure on tool pages
- System UI type only; tight title tracking
- Violet primary used sparingly; mint secondary for done/success only
- Flat tonal surfaces; motion is short and optional
- Verb-led CTAs; segmented format chips

## Colors

Cool near-white paper with a restrained violet accent and a mint reserved for completion.

### Primary
- **Workbench Violet** (`oklch(59.01% 0.19675 278.523)`): primary CTA fill, selected chips, focus ring, active nav bar. ≤ ~5% of any viewport.

### Secondary
- **Done Mint** (`oklch(78.158% 0.14381 171.311)`): success / done indicators only — never as a second brand accent on idle chrome.

### Neutral
- **Cool Paper** (`oklch(98.511% 0.00011 271.152)`): app background
- **Ink** (`oklch(21.82% 0.00195 286.055)`): body text
- **Card Mist** (`oklch(96.5% 0.00015 271.152)`): cards / elevated panels
- **Mute Wash** (`oklch(93% 0.00025 271.152)`): muted fills, active nav row
- **Hairline** (`oklch(88% 0.005 278.523)`): borders and inputs

### Named Rules
**The One Voice Rule.** Primary accent appears on ≤ ~5% of the viewport; rarity is the signal.

**The Mint Is Done Rule.** Secondary mint is reserved for success/done states only.

## Typography

**Display / Body Font:** system UI stack (`ui-sans-serif, system-ui, sans-serif`)
**Mono Font:** system mono for sizes, versions, percents

**Character:** Quiet OS-native type. No webfonts. Hierarchy comes from size, weight, and tracking — not personality typefaces.

### Hierarchy
- **Title** (600, `text-lg`, tight tracking): tool page titles
- **Body** (400, `text-sm`): supporting copy, dock summaries
- **Label** (500, `text-xs`, uppercase, `tracking-widest`, muted): section labels above controls
- **Mono** (400, `text-xs`): byte sizes, dimensions, percents

### Named Rules
**The System Stack Rule.** Do not add display webfonts to tool pages.

## Layout

Desktop operate shell: custom TopBar + collapsible Sidebar + content outlet. Tool pages share header rhythm `px-5 py-3`, edge-to-edge stage, dock `px-5 py-3`, filmstrip thumbs `w-24` with horizontal scroll. No three-pane settings workbench on media tools. Settings uses bordered cards and the same header rhythm. Home stays a centered wordmark composition.

Spacing follows Tailwind’s 4-point scale. Density is comfortable but chrome-light — the file owns the canvas.

## Elevation & Depth

Flat by default. Depth comes from tonal layering (background → card → muted) and hairline borders, not multi-layer shadows. Interactive lift on primary CTAs is a 1.5px translate on hover (opacity-only under reduced motion).

### Named Rules
**The Flat-By-Default Rule.** Surfaces rest flat. Motion and tint carry state, not drop shadows.

## Shapes

Base radius `--radius: 0.625rem` with sm/md/lg steps derived in CSS. Buttons and chips use `rounded-lg` / `rounded-md`. Cards and settings panels use the same radius language with `border-border`. No pill-full chrome on primary actions.

## Components

### Buttons
Primary: filled primary, `rounded-lg`, verb label, hover lift 1.5px, press `translateY(1px)`. Secondary: outline `border-border`, muted text. Disabled only while in-flight or missing required inputs (files; Convert also needs output folder).

### Format chips
Segmented control feel: selected = primary fill; idle = background + hairline border + muted text.

### Tool workbench
Header (icon + title + subtitle) → stage (empty drop or media preview) → optional dock → optional filmstrip. Drag overlay and busy overlay are first-class states.

### Sidebar / TopBar
Shared shell. Active nav: muted fill + 2px primary left bar. Tooltips delay 300ms on hover. Do not restyle Home or Sidebar as part of tool work.

### Settings cards
Bordered cards only; no stage, no enrichment.

## Do's and Don'ts

**Do**
- Keep tool pages stage-first with filmstrip + dock
- Use silent success (check + size delta)
- Preserve source files; force a suffix on path collision
- Extend this system when adding tools (Video matches Convert/Optimize chrome)

**Don't**
- Invent a second palette or loud enrichment on app pages
- Add celebratory toasts/confetti on convert/optimize/video success
- Restyle Home or Sidebar opportunistically
- Expose encoder knobs when presets carry the product voice
- Overwrite source media
Loading
Loading