Technical Documentation & Usage Guide
Welcome to onza.palette, an advanced, fully localized computational utility designed for frontend developers, UI/UX designers, and digital artists. This documentation outlines the structural methodology, algorithmic color generation, and privacy-first architecture underlying our minimalist color harmony engine.
Algorithmic Color Generation & Harmony Models
At the core of the onza.palette engine is a deterministic HSL (Hue, Saturation, Lightness) computational algorithm. Unlike standard random color generators, our system utilizes string-based seed hashing. When you input a descriptive "vibe" or select a preset chip, the text is converted into a 32-bit integer hash which is then mapped to a 360-degree color wheel. This ensures that a specific query will consistently yield mathematically balanced chromatic harmonies.
The system natively cycles through three distinct harmony algorithms:
- Analogous Scaling: Shifts the hue by subtle 15-degree increments while maintaining steady lightness stepping, ideal for creating unified, soothing UI gradients.
- Monochromatic Depth: Locks the base hue and generates contrast purely through stepped saturation (40% to 80%) and lightness (30% to 78%), perfect for brand-specific thematic styling.
- Triadic/Tetradic Distribution: Distributes hues across 120-degree intervals on the color wheel to ensure high-vibrancy, complementary accent palettes.
Client-Side Processing & Privacy Architecture
In strict adherence to modern data privacy standards, onza.palette operates entirely within a serverless, client-side architecture. When you upload an image for color extraction, the file is never transmitted to an external server. Instead, the application leverages the HTML5 Canvas API locally within your browser's sandboxed environment.
The extraction tool reads the pixel data directly from the local memory buffer, mapping coordinates across the canvas to sample dominant RGB values, which are subsequently converted to hexadecimal strings. Similarly, the "Local Vault" feature utilizes standard Web Storage API (localStorage), meaning your saved palettes persist only on your physical device and cannot be accessed, tracked, or compiled by any remote telemetry systems.
WCAG 2.1 Contrast & Accessibility Diagnostics
Digital accessibility is a non-negotiable standard in modern web development. The integrated Contrast Diagnostic tool evaluates your generated palettes against pure white backgrounds using the standard relative luminance formula. This mathematical approach calculates the perceived brightness of a color, providing a direct contrast ratio (e.g., 4.5:1 for standard text legibility).
Furthermore, the Color Blindness Simulator employs precise SVG matrix filters to emulate protanopia (red-blindness), deuteranopia (green-blindness), tritanopia (blue-blindness), and achromatopsia (monochromacy). By manipulating the rendering pipeline via feColorMatrix, designers can instantly verify if their UI elements retain distinct visual hierarchy and usability for users with visual deficiencies, ensuring inclusive design practices right from the ideation phase.