Architecting a zero-server-transit browser utility suite & AI toolbox.
Online utility websites are typically infested with invasive ads, aggressive paywalls, and silent cloud uploads that compromise user privacy. Freetles re-engineers everyday digital tools as client-side primitives: Turborepo modular architecture, WebAssembly processing, zero server file transit, and an intent-routed AI second front door.
The everyday web tool landscape is a privacy nightmare and an accessibility bottleneck.
When a user searches for 'compress PDF' or 'remove background from image', the top results force their private documents through foreign servers, impose artificial daily limits, or lock downloads behind subscriptions.
Most web tools upload confidential bank statements, IDs, and resumes to remote servers to perform operations that modern browsers can execute locally in milliseconds.
For users in emerging markets or on high-latency mobile data, uploading a 50MB file to compress it down to 5MB wastes both bandwidth and battery life.
Users often don't know the technical term for what they want ('interpolate bezier curve' vs 'smooth line'). Static navigation hierarchies fail users who describe problems in everyday language.
If a tool exists, the tool runs locally. The file never leaves the device.
Freetles draws an absolute privacy perimeter: the AI can parse natural-language intentions, but file bytes never cross the network. Modern browser runtimes (Wasm, OffscreenCanvas, Web Workers) provide all the computational power needed for desktop-grade utility tasks.
Zero-Server-Transit Privacy
Files never leave the user's browser. PDF manipulation, image compression, formatting, and cryptography occur 100% locally in browser memory.
Dual Front Door Experience
Static SEO-optimized deep links for direct search queries, paired with a natural-language AI concierge that routes conversational requests into exact tools.
Pure Typed Tool Functions
Every tool in tools-core is an isolated, deterministic function with Zod input/output schemas, making tools composable into chained workflows.
Bandwidth & Device Conscious
Engineered specifically for low-bandwidth and mid-tier mobile hardware, utilizing Web Workers to keep the UI thread silky and responsive.
The Dual Front Door Monorepo: Turborepo modular packages.
Freetles separates user experience into two complementary entry doors: static SEO-indexed deep-link pages and an interactive conversational AI Concierge that dynamically invokes typed tool functions.
User Interface (apps/web)
├─ Door 1: Direct Deep-Link (/tools/pdf/merge)
└─ Door 2: Conversational Concierge ("Combine these two invoices")
│
▼
Intent Matcher (@freetles/registry)
├─ Deterministic Keyword & Action Verb Parsing
└─ MIME Type & Schema Compatibility Resolution
│
▼
Tool Execution Engine (@freetles/tools-core)
├─ Web Worker Thread Spawning
├─ WebAssembly Processing (Wasm / Canvas)
└─ Pure Deterministic Functions (Zod Validated)
│
▼
Client Local Sandbox (Browser Memory)
├─ ArrayBuffer / Blob Generation (0 bytes to cloud)
└─ Offline IndexedDB Recent History & Cache| Package | Role in System | Implementation Detail |
|---|---|---|
| @freetles/tools-core | Pure Deterministic Engine | Contains 100% pure TypeScript functions for file manipulation, mathematical conversion, text analysis, and crypto operations with zero DOM dependencies. |
| @freetles/registry | Catalog & Intent Matcher | Defines tool manifests, metadata schemas, keywords, category hierarchies, and the natural language intent matcher that powers the AI concierge. |
| @freetles/brand | Design System & Tokens | Unified token system with dark-mode color primitives, typography rules, glassmorphism styles, and accessible micro-interaction standards. |
| apps/web | PWA Application & SEO | Next.js App Router frontend rendering 350+ individual tool landing pages, offline service workers, and interactive canvas components. |
The AI Second Front Door: Deterministic intent routing.
Unlike generic chat assistants that hallucinate file transformations, the Freetles AI concierge is strictly an intent-matching router. When a user describes a problem, the matcher extracts verbs and targets, searches registry manifests, and instantiates the corresponding tool interface instantly.
Natural Language Input
User types or drags a file into the concierge: 'Convert this photo to WebP and make it under 200KB.'
Intent Tokenization
Client-side intent parser scores verbs, file MIME types, and attributes against tool registry manifests in <5ms.
Local WebAssembly Worker
Tool-core spawns a background Web Worker, allocating an OffscreenCanvas or Wasm instance to compress the image locally.
Instant Blob Download
Generates a local Object URL for download or passes the resulting ArrayBuffer to the next chained tool.
WebAssembly in Web Workers: High-throughput local computation.
Performing complex manipulations (like optical character recognition, PDF splitting, or lossless image compression) directly on the main browser thread causes jank and drops frames. Freetles executes all heavy workloads inside isolated Web Workers.
// Main thread stays 100% responsive at 60fps
const worker = new Worker(new URL('./workers/pdf-engine.worker.ts', import.meta.url));
worker.postMessage({
command: 'MERGE_PDF_CHUNKS',
payload: { buffers: [fileBuffer1, fileBuffer2] }
}, [fileBuffer1, fileBuffer2]); // Zero-copy ArrayBuffer transfer
worker.onmessage = (e) => {
const resultBlob = new Blob([e.data.outputBuffer], { type: 'application/pdf' });
triggerDownload(resultBlob, 'merged_document.pdf');
};Using transferable objects (ArrayBuffer ownership transfer), gigabyte-sized files are passed to background threads in zero milliseconds without memory duplication.