A free, privacy-focused color conversion tool for designers and developers. Convert colors between CSS formats instantly and batch-process entire CSS/SCSS/PostCSS files—all client-side.
- Instant Conversion — Convert colors in real-time as you type with live preview
- Batch Processing — Upload CSS/SCSS files and convert all colors at once
- 100% Client-Side — All processing happens in your browser. No data sent to servers
- All CSS Formats — Supports HEX, RGB, HSL, HWB, LAB, LCH, OKLAB, OKLCH
| Format | Example | Description |
|---|---|---|
| HEX | #ff5733, #f53, #ff573380 |
Hexadecimal with optional alpha |
| RGB | rgb(255, 87, 51), rgba(255, 87, 51, 0.5) |
Red, Green, Blue |
| HSL | hsl(11, 100%, 60%), hsla(11, 100%, 60%, 0.5) |
Hue, Saturation, Lightness |
| HWB | hwb(11 20% 0%) |
Hue, Whiteness, Blackness |
| LAB | lab(62.83 56.25 46.63) |
CIE LAB perceptually uniform |
| LCH | lch(62.83 73.02 39.67) |
CIE LCH (cylindrical LAB) |
| OKLAB | oklab(0.68 0.13 0.1) |
Oklab perceptually uniform |
| OKLCH | oklch(0.68 0.17 40) |
OKLCH (cylindrical Oklab) |
All formats support alpha channel transparency.
- Framework: Nuxt 4 (Vue 3 Composition API)
- UI: Nuxt UI v4
- Color Library: culori for parsing and conversion
- Testing: Vitest + @nuxt/test-utils
- Linting: ESLint 9 + Prettier
- Git Hooks: Husky + lint-staged
- Node.js 18.x or higher
- npm, pnpm, or yarn
# Clone the repository
git clone https://github.com/FADL285/ColorShift.git
cd ColorShift
# Install dependencies
npm install# Start development server at http://localhost:3000
npm run dev# Generate static site for production
npm run generate
# Preview production build locally
npm run preview| Script | Description |
|---|---|
npm run dev |
Start development server |
npm run build |
Build for production (SSR) |
npm run generate |
Generate static site (SSG) |
npm run preview |
Preview production build |
npm run lint |
Run ESLint |
npm run lint:fix |
Run ESLint with auto-fix |
npm run format |
Check Prettier formatting |
npm run format:fix |
Auto-fix Prettier formatting |
npm run test |
Run Vitest tests |
ColorShift/
├── app/
│ ├── components/ # Vue components
│ │ ├── color/ # Color-specific components
│ │ └── Stars*.vue # Background effects
│ ├── composables/ # Vue composables
│ │ ├── useColorConverter.ts # Color conversion logic
│ │ ├── useColorFormats.ts # Format definitions
│ │ └── useFileProcessor.ts # Batch file processing
│ ├── layouts/ # Page layouts
│ ├── pages/ # Route pages
│ │ ├── index.vue # Single color converter
│ │ ├── file-converter.vue # Batch file converter
│ │ └── about.vue # About page
│ ├── app.config.ts # App configuration
│ └── app.vue # Root component
├── public/ # Static assets
├── test/ # Test files
│ └── unit/ # Unit tests
├── nuxt.config.ts # Nuxt configuration
└── vitest.config.ts # Vitest configuration
# Run all tests
npm run test
# Run tests in watch mode
npm run test -- --watch
# Run tests with coverage
npm run test -- --coverageColorShift is built with privacy as a core principle:
- No Server Processing — All color conversions happen in your browser using JavaScript
- No Data Collection — We don't collect, store, or transmit any of your color values or files
- No Cookies — ColorShift doesn't use tracking cookies or analytics
- Open Source — The source code is available on GitHub for full transparency
Your files never leave your computer. Everything is processed in your browser's memory.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'feat: add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Mohamed Fadl - @FADL285
Made with ❤️ using Nuxt and culori
Batch conversion parses CSS and brace-based SCSS declarations, including nested rules and SCSS variable values. Selectors, comments, strings, URLs, and interpolation spans are preserved. Indented .sass is not supported; export it as .scss or CSS first. Literal colors alongside interpolation and inside var()/env() fallbacks are converted. Invalid stylesheets show an error instead of producing a partially converted file. Parsing and conversion run in a cancellable Web Worker, and stale results are discarded when files or settings change.
Install Chromium with npx playwright-core install --with-deps chromium, then run npm run test:e2e. Browser tests run in Vitest's Node environment against the built app, using real input/conversion/worker/upload/download flows. A controlled worker stub is used only to deterministically deliver stale results after reset or while a replacement conversion is pending; the normal conversion and download journeys use the real worker. CI runs the browser suite for main-target and stacked fixes-target PRs.
Local browser execution may require network access for the Playwright browser download.