Project
CSS Unit Converter
A PROFESSIONAL CSS UNIT CONVERTER, BUILT FOR SPEED.
RoleSolo Developer
TimelineFeb 2025 - Present
The Vision
A lightning-fast, zero-noise CSS unit converter that runs entirely in the browser. Supports 7 distinct CSS units (px, rem, em, vw, vh, %, pt) with real-time translation across all of them based on customizable base font sizes and viewport dimensions. Designed for precision, minimalism, and speed.
The Problem
Most CSS unit converters online are bloated with ads, require multiple clicks to change between units, or don't allow you to set custom viewport contexts (like specific width and height). When you are deep into responsive design, you need to know exactly how your `px` values translate to `vw` or `rem` instantly. I wanted something that works at the speed of thought. You type a number, and you immediately see its equivalent in every other CSS unit. No ads, no page reloads, no cluttered UI.
Who This Is For
Frontend developers, UI/UX designers, and anyone working meticulously with responsive web design. If you frequently need to convert `px` to `rem` for accessibility or calculate `vw` for fluid typography, this tool serves as your instant reference.
Engineering Strategy
The technical reasoning behind the implementation.
Why Vite + React
This is a high-performance utility tool. There's no SEO-critical dynamic content that requires server-side rendering, and no backend data to fetch. Everything happens client-side: mathematical unit conversions based on a central context state.
Vite provides sub-second hot module replacement during development and produces highly optimized static bundles for production. The result is an application that loads almost instantaneously and computes conversions without any network latency.
Why Client-Side Everything
The conversion engine is entirely local to the browser:
1. Global State Context - A central state manages the base font size (default 16px) and viewport dimensions (1920x1080).
2. Instant Translation - The conversion logic normalizes any input to
px first, and then instantly fans it out to all 7 target units.
3. URL State Synchronization - The input value and source unit are synced naturally to the URL search parameters (?v=16&u=px), allowing you to bookmark or share specific conversions with your team without any database.
4. CSS Variable Export - A built-in clipboard utility maps the current results into a :root CSS variable block, ready to be copied to your stylesheet.Why Tailwind CSS & Shadcn UI
Utility-first styling allows for rapid UI assembly while keeping the codebase tight. The custom dark theme is driven by CSS variables combined with Tailwind's utility classes. Radix UI primitives provide accessible, unstyled components that guarantee perfect keyboard navigation and screen reader support out of the box.
The typography choice (monospace space-mono/JetBrains) gives the interface a deeply technical, tool-like aesthetic—exactly what power users expect from a developer tool.
Why TypeScript
When converting between 7 different units (
CSSUnit type), you need absolute certainty. The ALL_UNITS array and strict typing ensure that the conversion algorithms never miss a unit or mishandle a string. TypeScript guarantees that the context always contains the correct baseFontSize, viewportWidth, and viewportHeight as numbers, preventing silent NaN errors during mathematical operations.Technologies
Framework
Vite 5 + React 18 - blazing fast HMR, optimized static output. No SSR needed for a pure client-side mathematical tool.
Language
TypeScript - strict typing for unit definitions, conversion context, and mathematical operations.
Styling
Tailwind CSS 3 - utility-first with custom CSS variables. Styled for a technical, precise aesthetic.
UI Components
Radix UI + Shadcn UI - accessible, composable primitives with full styling control and sonner for toast notifications.
Icons & Fonts
Lucide React for crisp iconography and Space Mono for a technical, developer-centric typography.
Core Features
- Real-Time Omnidirectional ConversionType any value into the input field and choose your source unit. The app instantly translates it into px, rem, em, vw, vh, %, and pt simultaneously across a responsive grid.
- Contextually AwareChange the base font size or viewport dimensions in the settings panel. All conversions update live based on your custom context.
- Keyboard-First WorkflowHit Cmd/Ctrl+K from anywhere in the app to instantly focus the input field and select its contents. No need to reach for the mouse.
- Copy as CSS VariablesGenerate a perfectly formatted :root block containing all current unit conversions as CSS variables, ready to be copied to your clipboard with a single click.
- URL State SynchronizationYour current input value and source unit are automatically synced to the URL. Share a link like /?v=24&u=px with a colleague.
- Zero Tracking, Zero AdsA pure, privacy-first tool. No analytics scripts, no tracking cookies, no ads. Built solely to solve a problem efficiently.