<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: zhouming</title>
    <description>The latest articles on DEV Community by zhouming (@_c2c381a915acd879e50d86).</description>
    <link>https://dev.to/_c2c381a915acd879e50d86</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4258649%2F18d9f4e0-5e53-428c-82f0-8a69f05f35e8.png</url>
      <title>DEV Community: zhouming</title>
      <link>https://dev.to/_c2c381a915acd879e50d86</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/_c2c381a915acd879e50d86"/>
    <language>en</language>
    <item>
      <title>Building a Privacy-First Drawing Grid Tool in the Browser (Zero Image Uploads with HTML5 Canvas)</title>
      <dc:creator>zhouming</dc:creator>
      <pubDate>Sun, 22 Nov 2026 11:29:12 +0000</pubDate>
      <link>https://dev.to/_c2c381a915acd879e50d86/building-a-privacy-first-drawing-grid-tool-in-the-browser-zero-image-uploads-with-html5-canvas-2k4b</link>
      <guid>https://dev.to/_c2c381a915acd879e50d86/building-a-privacy-first-drawing-grid-tool-in-the-browser-zero-image-uploads-with-html5-canvas-2k4b</guid>
      <description>&lt;p&gt;Drawing with a reference grid is one of the oldest proportion techniques in studio art: overlay evenly spaced, labeled squares (&lt;code&gt;A1&lt;/code&gt;, &lt;code&gt;B1&lt;/code&gt;, &lt;code&gt;C2&lt;/code&gt;) on a reference photo, rule matching squares on paper or canvas, and copy one cell at a time.&lt;/p&gt;

&lt;p&gt;Yet most online grid generators still upload the user's photo to a backend server just to draw twenty straight lines and return a JPEG. For artists working from family portraits, client commissions, or student photos in a classroom, uploading personal images to a third-party server is unnecessary latency, storage cost, and privacy risk.&lt;/p&gt;

&lt;p&gt;While building &lt;a href="https://easygridmaker.com/" rel="noopener noreferrer"&gt;Easy Grid Maker&lt;/a&gt;, I kept the entire pipeline inside the browser using HTML5 Canvas, SVG, and browser print CSS. Here are the concrete engineering problems that showed up along the way—and the small, practical patterns that solved them.&lt;/p&gt;

&lt;h2&gt;
  
  
  1. Zero-Upload File Ingestion (Including iPhone HEIC)
&lt;/h2&gt;

&lt;p&gt;The privacy guarantee starts with never constructing a &lt;code&gt;FormData&lt;/code&gt; upload or base64 POST payload. Instead, user files stay in local memory via &lt;code&gt;URL.createObjectURL(file)&lt;/code&gt; and are revoked as soon as a new photo replaces them or print cleanup finishes.&lt;/p&gt;

&lt;p&gt;Two real-world edge cases immediately break a naive &lt;code&gt;Image&lt;/code&gt; loader:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Tainted or unreadable SVGs&lt;/strong&gt;: Some SVG files with foreign content decode cleanly into an &lt;code&gt;HTMLImageElement&lt;/code&gt; but throw a security error as soon as you export the canvas. Probing a 1×1 offscreen canvas with &lt;code&gt;ctx.getImageData(0, 0, 1, 1)&lt;/code&gt; right after &lt;code&gt;image.decode()&lt;/code&gt; catches unreadable files up front instead of failing at download time.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;iPhone HEIC files on Chrome/Firefox&lt;/strong&gt;: Safari decodes HEIC natively, while Chromium and Firefox do not. Worse, some OS file pickers hand over HEIC images with an empty MIME type or a generic filename.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Instead of bundling a heavy WASM/JS HEIC decoder in the main chunk, try native decoding first, sniff the first 12 bytes for an ISO BMFF &lt;code&gt;ftyp&lt;/code&gt; brand (&lt;code&gt;heic&lt;/code&gt;, &lt;code&gt;heix&lt;/code&gt;, &lt;code&gt;hevc&lt;/code&gt;, &lt;code&gt;mif1&lt;/code&gt;), and dynamically import the CSP-safe decoder only when needed:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;looksLikeHeic&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;firstBytes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;Uint8Array&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;boolean&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;image&lt;/span&gt;\&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;heic&lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="n"&gt;heif&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;\&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;heic&lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="n"&gt;heif&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;$&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;brand&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;String&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;fromCharCode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;firstBytes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;slice&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;12&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="o"&gt;/^&lt;/span&gt;&lt;span class="nf"&gt;ftyp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;heic&lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="n"&gt;heix&lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="n"&gt;hevc&lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="n"&gt;hevx&lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="n"&gt;heim&lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="n"&gt;heis&lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="n"&gt;mif1&lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="n"&gt;msf1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;brand&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If you also run session-replay analytics on your marketing site, remember to mask the rendered canvas and print containers (for example with &lt;code&gt;data-clarity-mask="true"&lt;/code&gt;) so third-party replay scripts cannot capture local images either.&lt;/p&gt;

&lt;h2&gt;
  
  
  2. Pure Grid Math Without Floating-Point Ghost Columns
&lt;/h2&gt;

&lt;p&gt;Separating grid geometry into a pure TypeScript module with zero DOM dependencies makes unit testing trivial and keeps preview, export, and print layouts identical.&lt;/p&gt;

&lt;p&gt;When users choose a square-grid density (such as 3, 5, or 8 squares across the shorter side), each cell's width equals &lt;code&gt;Math.min(width, height) / squaresAcross&lt;/code&gt;. A classic floating-point bug happens when &lt;code&gt;width / cell&lt;/code&gt; evaluates to &lt;code&gt;5.000000000000001&lt;/code&gt;—&lt;code&gt;Math.ceil()&lt;/code&gt; turns a clean 5-column image into 6 columns with an invisible 1-pixel sliver on the right edge.&lt;/p&gt;

&lt;p&gt;Subtracting a small epsilon solves this cleanly:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;cell&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;min&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;width&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;height&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="n"&gt;across&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;count&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;side&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;number&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;ceil&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;side&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="n"&gt;cell&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="mf"&gt;1e-6&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For custom grids, supporting either one axis or both axes gives artists what they actually expect: typing only &lt;code&gt;columns&lt;/code&gt; or only &lt;code&gt;rows&lt;/code&gt; keeps every cell strictly square (&lt;code&gt;cellHeight = cell&lt;/code&gt;), while filling in both lets the grid stretch to match a target canvas aspect ratio. On partial edge strips (when a photo's aspect ratio is not an exact multiple of the cell size), suppressing coordinate labels whenever a strip is narrower than 35% of a full cell prevents overlapping text like &lt;code&gt;G1&lt;/code&gt; spilling over the border.&lt;/p&gt;

&lt;h2&gt;
  
  
  3. Auto-Contrast Lines and Crisp 1-Pixel Strokes
&lt;/h2&gt;

&lt;p&gt;A black grid disappears over dark hair; a white grid vanishes over a bright sky. Asking every user to tweak colors before seeing a usable result adds friction.&lt;/p&gt;

&lt;p&gt;A fast, reliable default is sampling mean Rec. 709 luminance on a tiny 32×32 offscreen canvas (composited over white so transparent PNGs judge accurately):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Rec. 709 luminance (0..1)&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;lum&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mf"&gt;0.2126&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mf"&gt;0.7152&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;g&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mf"&gt;0.0722&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;255&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If mean luminance exceeds &lt;code&gt;0.55&lt;/code&gt;, pick dark lines (&lt;code&gt;#111111&lt;/code&gt;) with a semi-transparent white halo (&lt;code&gt;rgba(255, 255, 255, 0.7)&lt;/code&gt;); otherwise pick white lines (&lt;code&gt;#ffffff&lt;/code&gt;) with a dark halo (&lt;code&gt;rgba(0, 0, 0, 0.6)&lt;/code&gt;). Drawing every grid line in two passes—first a wider halo pass, then the core stroke—keeps lines readable even when a single line crosses both sunlight and deep shadow.&lt;/p&gt;

&lt;p&gt;Two extra Canvas details make a noticeable visual difference:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Half-pixel snapping&lt;/strong&gt;: In HTML5 Canvas, an odd-width stroke placed at an integer coordinate straddles two physical pixels and blurs into gray. Snapping coordinates with &lt;code&gt;Math.round(value) + (lineWidth % 2 === 1 ? 0.5 : 0)&lt;/code&gt; keeps thin lines razor sharp.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;iOS Safari canvas memory cap&lt;/strong&gt;: iOS Safari silently fails or blanks out canvases exceeding &lt;code&gt;16,777,216&lt;/code&gt; total pixels (&lt;code&gt;4096 × 4096&lt;/code&gt;). Clamping export dimensions to &lt;code&gt;16_000_000&lt;/code&gt; pixels—and resetting temporary canvas &lt;code&gt;width&lt;/code&gt; and &lt;code&gt;height&lt;/code&gt; to &lt;code&gt;0&lt;/code&gt; immediately after &lt;code&gt;toBlob()&lt;/code&gt;—prevents mobile tab crashes on 48 MP smartphone photos.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  4. True-to-Scale Printing: Raster Photo + Vector Blank Grid
&lt;/h2&gt;

&lt;p&gt;Artists rarely want only a gridded JPEG; they want two matching sheets at the exact same physical scale:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Sheet 1: the reference photo with its numbered grid.&lt;/li&gt;
&lt;li&gt;Sheet 2: a blank grid with the exact same cell dimensions in millimeters or inches to draw on directly.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Rendering Sheet 2 as a raster canvas wastes memory and looks fuzzy on laser printers. Instead, inject a print-only DOM container with an &lt;code&gt;&amp;lt;img&amp;gt;&lt;/code&gt; (from the exported photo blob) on page 1 and an inline &lt;code&gt;&amp;lt;svg&amp;gt;&lt;/code&gt; with explicit millimeter &lt;code&gt;width&lt;/code&gt; and &lt;code&gt;height&lt;/code&gt; attributes on page 2, paired with a dynamic &lt;code&gt;@page&lt;/code&gt; rule:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="n"&gt;pageStyle&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;textContent&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
  &lt;span class="sb"&gt;`@page { size: ${print.pageWidthMm}mm ${print.pageHeightMm}mm; margin: 0; }`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Both pages automatically switch orientation to portrait or landscape based on &lt;code&gt;layout.width &amp;gt; layout.height&lt;/code&gt;, pick Letter or A4 from the browser locale, and print a single footer line reporting the exact physical square width (for example, &lt;code&gt;1.48 in&lt;/code&gt; or &lt;code&gt;3.2 cm&lt;/code&gt;) so the artist can verify the print with a ruler at 100% scale.&lt;/p&gt;

&lt;p&gt;The same millimeter-first SVG and PDF pipeline also powers standalone sheets like the &lt;a href="https://easygridmaker.com/printable-grid-paper" rel="noopener noreferrer"&gt;printable grid paper generator&lt;/a&gt;, where Letter sheets use exact &lt;code&gt;1/4&lt;/code&gt;, &lt;code&gt;1/2&lt;/code&gt;, and &lt;code&gt;1 inch&lt;/code&gt; cells and A4 sheets use &lt;code&gt;5 mm&lt;/code&gt;, &lt;code&gt;1 cm&lt;/code&gt;, and &lt;code&gt;2 cm&lt;/code&gt; cells—all generated client-side without touching a server.&lt;/p&gt;

&lt;h2&gt;
  
  
  Closing Takeaway
&lt;/h2&gt;

&lt;p&gt;If your web tool processes user media deterministically—grids, aspect-ratio cropping, image splitting, or printable sheets—you rarely need a backend upload pipeline. Modern browsers already ship fast Canvas 2D compositing, &lt;code&gt;Blob&lt;/code&gt; URLs, dynamic WASM/JS imports for edge-case formats like HEIC, and millimeter-accurate SVG print output. Keeping pixels on the user's device eliminates server bills, cuts latency to near zero, and makes privacy a verifiable architectural property rather than a policy promise.&lt;/p&gt;

</description>
      <category>webdev</category>
    </item>
  </channel>
</rss>
