TOOL-0 verifies the shared integration boundary before the first real PDF tool is added.
waiting
Design Token Contract
First Plugin Visual Tokens
DESIGN-7 uses the approved token source and adds responsive QA for Start, Workspace, and Export / Result production surfaces.
tokens extracted
Primary blue#2563eb / #1d4ed8
Soft blue surface#eff6ff / #f8fbff
App surfacewhite glass + blue border
Success stategreen status family
Progress gradientblue → cyan
Button shadow0 18px 42px blue alpha
Shared Production Flow Visual QA
Start, Workspace, and Export Result Visual Readiness
DESIGN-7 verifies the final shared production surfaces across desktop, tablet, and mobile before Add Page Numbers or any tool-specific module is mounted.
waitVisual QA has not run yet.Run the visual QA once before moving from shared design into the first real tool.
Shared Production Design Final Lock
Desktop, Tablet, and Mobile Readiness
DESIGN-7 checks that the finalized Start, Workspace, Tool Panel Slot, and Export Result surfaces stay readable, bounded, and stacked correctly before tool-specific work begins.
waiting
viewport: checkingdesktoptabletmobile
0Passed
0Warnings
0Failed
Desktop>= 1120px · two-column workspace when room exists
Tablet721–1119px · right tool panel stacks below workspace
Mobile<= 720px · full-width controls, compact preview, no horizontal overflow
waitResponsive QA has not run yet.Run the responsive QA on desktop, tablet, mobile, and after uploading a PDF.
Shared Production Design Final Lock
Start, Workspace, and Export Result are frozen for tool work
DESIGN-7 locks the approved visual contract from the first plugin. Future tools only provide copy, icon, right-panel controls, overlays, export handler, and result summary data.
waiting
Start lockedWorkspace lockedExport locked
0Passed
0Warnings
0Failed
Shared ownsStart shell, workspace frame, process shell, result shell, upload pipeline, session, and PDF engine.
Tool ownsIcon, title, subtitle, right panel content, overlay content, export handler, and result summary values.
Do not changeNo new tool should redefine Start, Workspace, Export, Result, or shared colors/spacing.
waitFinal design lock has not run yet.Run this once after Start, Workspace, mock Export, Visual QA, and Responsive QA are checked.
Shared Tool + Export Reuse Contract
Verify how a future tool reuses shared workspace and export
This audit proves that a tool only supplies config, right-panel controls, export handler, filename, and result summary while shared Start, Workspace, Export, Result, Session, and Engine stay owned by the foundation.
Shared ownsStart, workspace, upload, PDF engine, canvas, export process, ready/result surface, changed file, validation, download guard, and session.
Tool ownsCopy/icon config, right-panel controls, settings, overlay content, export handler, output filename, and result summary.
TOOL-0 adapterNeutral test adapter or production consumer only. Shared export must not become hardcoded to Add Page Numbers.
waitTool integration check has not run yet.Run this before wiring another tool into the shared export adapter contract.
production tool
Shared StartSame design for every tool. Tool changes icon, title, subtitle, CTA and benefit cards.
Unified UploadEvery visible Choose PDF / Replace PDF action enters processSelectedPdf(file, source): validation, session, PDF engine, then the real production workspace surface.
Shared WorkspaceLeft PDF area stays shared. Right side is a Tool Panel Slot.
Shared OverlayNeutral coordinate layer belongs to shared workspace; future tools provide overlay content.
Shared ValidationOne catalog normalizes upload, PDF engine, canvas render, page scope, export, and result errors.
Shared ExportShared process state runs a mock handler now and calls the active tool export handler later.
Shared ResultSame result design. Tool provides output filename, download blob, and summary values.
PDF
Local browser PDF tool
Add Page Numbers to PDF
Place page numbers exactly where you want, then export a clean PDF locally in your browser.
Choose a PDF to begin
Click anywhere in this panel, drag and drop a PDF, or use the button.
↳No signupUse it directly in the browser.
◇No watermarkExport a clean PDF result.
⌂Private by designFiles stay on your device.
#1Add Page NumbersYour PDF is ready for page numbering settings.4 pages · Page 1 of 4 · Sequential numbered pages · All pages
Preview pageCheck placement before export
PagePage 1 of NViewFit pageNumbered preview
Preview / overlay
Overlay help: click a preview overlay to select it. Drag to move it. Use arrow keys to nudge it, Shift plus arrow keys to move faster, and Escape to unselect.
Workspace ready.
!
Workspace needs attention
The shared workspace could not complete this action.
Code: workspace_error
You can retry, replace the PDF, or start over.
PagesChoose a page to preview.
Muted = skipped
File detailsSingle PDF selected
FileNo PDF loaded
SizeChoose a PDF to activate the shared workspace.
EnginePDF engine loading
#1Export PDFShared export panel for every tool.
#1
Preparing export
Exporting your PDF
Building the PDF locally in your browser. The shared export system owns this panel; the active tool supplies the handler and summary values.
Preparing…0%
Export detailsReview the changed file and export details before download.
—total pages—pages processed—output sizenumbered-document.pdfsaved as filename
Changed filenumbered-document.pdfCreated from the uploaded PDF.
Input and output size will appear after export.
This result is out of date. Export again before downloading.
Shared DESIGN-7 locks the production Export / Result design while keeping upload, PDF.js canvas renderer, workspace, and right-side tool panel slot ready.
Choose or drop a PDF from this slot, the production preview button, or any Replace PDF action. All visible upload triggers now use one file input and one validation → session → PDF engine → workspace pipeline.
Acceptedapplication/pdf,.pdf
Max size100 MB
Large warning25 MB+
Shared DESIGN-7 locks the production Export / Result design while keeping upload, PDF.js canvas renderer, workspace, and right-side tool panel slot ready.
Workspace Slot
Shared Workspace Contract
DESIGN-7 preserves the finalized Workspace design and locks the Export / Result design from the first plugin: progress, result summary, download row, edit settings, and start over.
No file loaded
validatedNo pages loaded
— / 0
No pageUpload a PDF to prepare the workspace.
Zoomfit
Layoutcards
StatusWorkspace waits for PDF engine page data.
CanvasWaiting for PDF bytes.
Selection State · 0
Page Size Samples
Shared Overlay + Coordinate Slot
Overlay / Coordinate Contract
DESIGN-7 preserves the neutral overlay layer while Export / Result design is locked.
shared coordinate system
Preview rectanglenone
PDF rectanglenone
Current page sizeNo PDF loaded
Scalenone
Upload a PDF before testing overlay coordinates.
Shared Layout Contract
Shared Asset Boundaries
This bench locks the neutral structure: shared start page first, shared workspace after a PDF is loaded, right-side Tool Panel Slot for each future tool, then shared process/export and result shells.
boundary locked
1. Start PageShared upload, drag/drop, validation, replace and clear.
2. WorkspaceShared PDF work area, navigation, cards/list, selection and zoom.
3. Tool Panel SlotShared container only. Content belongs to the active tool.
4. Process / ExportShared processing state and future export handoff.
5. ResultShared output, download and stale-result shell.
Optional Shared Components
Reusable Components Bench
These components are available to future tools, but they are not forced into every tool. Page scope is shown here only to test the reusable contract.
optional
OPTIONAL REUSABLE COMPONENT
Optional Page Scope Component
Reusable target-page resolver. A real tool may mount this component inside its own panel or workflow, but it is not the shared workspace itself.
0 target pages
Modeall
Upload a PDF to resolve shared target pages.
Resolved summarynone
Warningsnone
Errorsnone
Process / Export Slot
Shared Export Controller
DESIGN-7 locks the universal processing and result visual shell. This bench still uses a mock export blob only.
idle
StateNo process running.
Progress0%
Handlershared mock export
Upload a PDF, then run the shared mock export to test process and result state.
Result Slot
Shared Result Controller
The result shell owns success, error, stale, download, edit-settings, and start-over states. Future tools only provide the result summary and file blob.
idle
No shared result yet
No result yet.
This result is stale because the PDF, scope, or settings changed after export.
