OnlineFreeTools.org
  • Home
  • Image editing tools
    • Add Text Watermark to Photo — Local Browser Tool
    • Extract Colors from Image — Palette & Click Pick
    • Flip Image — Mirror Horizontally or Vertically
    • Add Border to Image — Color & Width Online
    • Image Compressor — Resize, Quality & Target Size Local
    • Crop & Resize Image — Local Aspect Presets
    • Photo EXIF Viewer & Remover — GPS, Camera & Local Strip
    • Image Format Converter — PNG JPEG WebP AVIF BMP GIF ICO SVG
    • Convert Image to Grayscale — Black & White Online
    • Merge Images — Combine Photos into One Collage
    • Image Optimizer — WebP, AVIF & MozJPEG Local
    • Overlay Images — Put a Logo on a Photo
    • Image to Base64 Converter — Encode & Decode Locally
    • Images to GIF — Make an Animated GIF Locally
    • Images to PDF — Combine Photos into One File
    • Images to PowerPoint — Photos to PPTX Slides
    • Images to Word — Build a DOCX from Photos
    • PDF Page to Image Sizes — Multi-Size Export Pack
    • PDF to JPG — Convert Pages to Images in Your Browser
  • Design tools
    • Generate Brand Color Scale — 50–950 Palette & CSS Tokens
    • Brand Style Guide — Generate a Modular Draft You Can Edit
    • Smart Website Color Scheme — Semantic CSS Tokens
    • WCAG Contrast Checker — AA/AAA Ratio Online
  • PDF tools
    • Compress PDF — Shrink File Size in Your Browser
    • Crop PDF — Trim Page Margins in Your Browser
    • Merge PDF — Combine Files in Your Browser
    • Organize PDF — Reorder or Remove Pages in Your Browser
    • Add Page Numbers to PDF — In Your Browser
    • PDF to Markdown — Extract Text for Notes in Your Browser
    • PDF Watermark — Stamp Text on Every Page in Your Browser
    • Protect PDF — Password-Encrypt in Your Browser
    • Rotate PDF — Fix Page Orientation in Your Browser
    • Split PDF — Extract Pages Locally
    • Unlock PDF — Remove Password You Already Know
  • Developer
    • Add WWW to DNS — A/CNAME, Apex Rules & Provider Guides
    • Archive Extractor Online — Open Compressed Files in Your Browser
    • Base64 Encode & Decode — Convert Text in Your Browser
    • Core Web Vitals Checker
    • CSV ↔ JSON Converter — Types, Delimiters & Local
    • Domain Lookup — Check DNS Records & Registration Online
    • File Hash Checker — Verify Digests in Your Browser
    • Hreflang Generator
    • HTML Entity Encoder & Decoder — Escape, Unescape & Local
    • IndexNow — Bing URL Submit, Key Check & Status Codes
    • What Is My IP Address — See Your Public IP (IPv4 or IPv6)
    • JSON Schema Validator — Draft-07 Paths & Local
    • JWT Decoder — Read Header & Payload Locally (No Verify)
    • Magnet Link Decoder — Parse Info Hash and Trackers Locally
    • Markdown ↔ HTML
    • Google SERP Preview
    • Meta Tag Generator
    • On-Page SEO Checker
    • Open Graph Preview
    • Random Password Generator — Create Passwords Locally
    • Robots.txt Generator
    • JSON-LD Schema Generator
    • XML Sitemap Generator
    • Compare Two Texts Online — Text Diff Checker
    • Time Zone Converter — Compare One Moment Worldwide
    • Unix Timestamp Converter — Epoch ↔ Readable Time
    • Unzip File Online — Extract ZIP Files in Your Browser
    • UTM Builder
    • UUID & ULID Generator — Create IDs in Your Browser
    • Check HTTP Response Headers
    • YAML ↔ JSON Converter — Types, Multi-doc & Local
  • Calculators
    • Acceleration Calculator — Change in Velocity
    • Age Calculator — Chronological Age from Birthdate
    • Aspect Ratio Calculator — How to Calculate and Scale Ratios
    • BMI Calculator — How to Calculate Body Mass Index
    • BMR & TDEE Calculator — How to Calculate Daily Calories
    • Body Fat Calculator — How to Estimate Body Fat Percentage
    • Break-Even Calculator — How to Calculate Break-Even Point
    • CAGR Calculator — How to Calculate Compound Annual Growth Rate
    • Circle Calculator — Area and Circumference
    • Compound Interest Calculator — How to Calculate Future Value
    • Concrete Calculator — How to Estimate Concrete Volume
    • Confidence Interval Calculator — How to Calculate a CI
    • Contribution Margin Calculator — Price Minus Variable Cost
    • Date Difference Calculator — Days and Weeks
    • Debt Payoff Calculator — Months to Clear a Balance
    • Density Calculator — Mass over Volume
    • Discount Calculator — How to Calculate Sale Price
    • EMI Calculator — How to Calculate Loan Payments
    • Exponent Calculator — How to Calculate Powers
    • GPA Calculator — How to Calculate Weighted GPA
    • Gradient Calculator — Multivariable ∇f (Partial Derivatives)
    • Gross Margin Calculator — How to Calculate Gross Margin
    • Heart Rate Zone Calculator
    • Ideal Weight Calculator — How to Estimate Ideal Body Weight
    • Inflation Calculator — Future Purchasing Power
    • IRR Calculator — Internal Rate of Return
    • Logarithm Calculator — How to Calculate Logs
    • Macro Calculator — Calories to Protein Carb Fat Grams
    • How to Calculate Marginal Revenue — MR Calculator (ΔTR / ΔQ)
    • Markup Calculator — How to Calculate Markup Percentage
    • Mean Calculator — Average of a Number List
    • Median and Mode Calculator
    • How to Calculate NPV — Net Present Value Calculator
    • Ohm’s Law Calculator — Resistance and Power
    • One-Rep Max Calculator (Epley)
    • P-Value Calculator — How to Calculate a P-Value
    • Pace Calculator — min/km and Speed
    • Paint Calculator — How to Estimate Paint Needed
    • Payback Period Calculator — Years to Recover Investment
    • Percentage Change Calculator — From Old Value to New
    • Permutation and Combination Calculator
    • Present Value Calculator — PV and FV Modes
    • Profit Margin Calculator — Net or Operating Margin
    • Pythagorean Theorem Calculator — How to Find a Missing Side
    • Quadratic Equation Solver — Roots and Discriminant
    • ROI Calculator — How to Calculate Return on Investment
    • Rule of 72 Calculator — Years to Double
    • Salary to Hourly Calculator — How to Convert Pay Rates
    • Sample Size Calculator — How to Estimate Required n
    • Scientific Notation Calculator — How to Convert Scientific Notation
    • Significant Figures Calculator — How to Count and Round Sig Figs
    • Slope Calculator — How to Calculate Slope Between Two Points
    • Standard Deviation Calculator — How to Calculate SD and Variance
    • Tile Calculator — How to Estimate Tile Quantity
    • Tip Calculator — Tip Amount and Split
    • Triangle Area Calculator
    • VAT / GST Calculator — Add or Extract Tax
    • Velocity Calculator — Distance over Time
    • Volume Calculator — Box and Sphere
    • Z-Score Calculator — How to Calculate a Standard Score
    • Square Feet to Square Meters — Area Converter for Homes & Renovation
    • Unit Converter — Length / Mass / Temperature / Area / Volume / Speed
  • where2use
  • Tool types
  • Dev Logs

Navigation

Home

Implemented protect-pdf tool with browser-side password encryption, 10-locale i18n, and all gates green. | Dev Logs

Back to Logs

Date: 2026-08-08 20:35 Summary: Implemented protect-pdf tool with browser-side password encryption, 10-locale i18n, and all gates green.

[question] Implement full protect-pdf in /Users/xuli/vscodeai/onlinefreetools.

Spec

  • slug: protect-pdf, category: pdf, #59 P2
  • work-tasks ready. Title: "Protect PDF — Password-Encrypt in Your Browser"
  • Tech: pdf-lib@1.17.1. After load, call pdfDoc.encrypt({ userPassword, ownerPassword: userPassword }) then save(). Reject empty password. UI: password + confirm password fields (must match).
  • related: will be ["unlock-pdf","merge-pdf"] — if unlock-pdf not in catalog yet, use ["merge-pdf","organize-pdf"] temporarily; prefer unlock-pdf if exists.
  • loadSample(): create 1-page sample, encrypt with password "sample", downloadable protected.pdf. Show the sample password in status/UI so user knows.
  • FAQ must say this is user-password encryption, not military-grade; unlock needs the password (link narrative to unlock tool). NOT cracking.
  • Privacy device+no server; 25MB soft warn

Create catalog, icon, protectPdfPage.ts, 10 i18n full independent.

Update 02/03 1b+2b (en,zh,es,ja), inventory #59, README

Gates until green:

npm run merge:tools && npm run coverage:gate -- --slug=protect-pdf --phase=all && npm run build:site && npm run lint:seo && CROSS_TOOL_UPDATE=1 TOOL_SLUG=protect-pdf npm run lint:tool-isolation

Verify pdf-lib encrypt API works in the page script (PDFDocument.encrypt before save). If API differs, check pdf-lib docs — method is on PDFDocument instance: doc.encrypt({ userPassword, ownerPassword }).

No plan/commit. 中文 brief. Chinese comments.

[try to solve] Shipped full protect-pdf with all gates green.

Deliverables

  • New catalog shard, protectPdfPage.ts, icon, ten-locale i18n; related temporarily merge-pdf + organize-pdf (unlock-pdf not shipped yet).
  • UI: PDF upload + password / confirm (must match; empty rejected); Protect / Download / Sample / Clear; ~25 MB soft warn.
  • loadSample(): on enter, builds a 1-page sample encrypted with password sample, enables protected.pdf download, shows sample password in status.
  • FAQ: user-password encryption, not military-grade; later unlock with known password (not cracking); privacy = device, no server upload.

Tech note

  • Stock pdf-lib@1.17.1 has no PDFDocument.encrypt (GitHub #1680). Page uses CDN pdf-lib-with-encrypt@1.2.1 with the same API: doc.encrypt({ userPassword, ownerPassword }) → save().

Docs

  • 02 → implemented; 03 1b/2b and i18n-done; inventory #59 → shipped; README EN/ZH entries.

Gates

  • coverage:gate --phase=all ✓
  • build:site ✓
  • lint:seo ✓
  • lint:tool-isolation ✓

[actions]

  • src/site/tool-catalog.d/protect-pdf.json
  • src/pages/protectPdfPage.ts
  • src/site/i18n/tools/protect-pdf/*.ts (10 locales)
  • public/icons/tools/protect-pdf.svg
  • work-tasks/protect-pdf/02-tool-info.md, 03-locale-briefs.md
  • docs/2026-08-08-tool-inventory-table.md
  • README.md
OnlineFreeTools.org · Learning project · Iterating
About·Privacy·Terms·Contact·GitHub