A local workspace for extracting, editing, reviewing, saving, and exporting color palettes.
ColorCraft creates a palette from a source image or from colors that you enter manually. It reviews geometric hue relationships and defined color-pair contrast, proposes optional colors, and generates browser-side exports.
- Create a palette from a JPG, PNG, or WebP source image, select Start manually, or import a ColorCraft JSON file.
- Edit, name, reorder, add, duplicate, remove, or sample palette colors.
- Select Analyze palette.
- Use Overview, Harmony, Contrast, and Suggestions in Review.
- Assign color roles and evaluate the applicable contrast pairs.
- Use Export to generate CSS custom properties, JSON, Tailwind theme colors, or an SVG swatch sheet.
- Select Copy or Download.
Relationship fit measures geometric agreement with documented hue structures, not aesthetic quality. Text, non-text, and focus-indicator checks use the threshold for the identified role pair. They do not prove complete WCAG conformance.
The API accepts a source image up to 10 MB and 40 million decoded pixels. Extraction returns 3–10 requested colors, or fewer for a limited processing sample. Save palette stores a versioned record in IndexedDB. The Library can open, search, rename, duplicate, and delete saved palettes.
ColorCraft has no accounts or cloud synchronization. Source-image bytes and unsaved changes remain session-only. Browser history stores the active view and Review tab, not palette data. Export generation runs in the browser.
ColorCraft JSON import is also browser-only. New exports use portable schema version 3 with document-local color keys. Imports accept versions 1, 2, and 3, validate the complete file before changing the workspace, and leave an imported palette unsaved until Save palette is selected. CSS and Tailwind exports include semantic role tokens for assigned colors.
The shell reports Loopback only or LAN enabled from runtime metadata. SVG exports select black or white swatch labels by measured contrast.
Use Python 3.11 and Node.js 20 or newer:
py -3.11 -m venv backend\.venv311
.\backend\.venv311\Scripts\python.exe -m pip install -r backend\requirements-dev.txt
cd frontend
corepack pnpm@9.15.9 install
cd ..
.\backend\.venv311\Scripts\python.exe dev.pyThe web application starts at http://127.0.0.1:5174; the API starts at http://127.0.0.1:4100. The default configuration accepts loopback traffic only. Trusted LAN access expands the security boundary and requires opt-in.
Read Getting started for Windows, macOS, Linux, manual startup, configuration, shutdown, and recovery procedures.
Use the documentation index for user, technical, operations, and contribution guides. All documentation follows ColorCraft Technical English.
Run the complete local and CI gate:
.\backend\.venv311\Scripts\python.exe check.pyThe gate checks formatting, linting, types, tests, coverage, the production build, browser workflows, and representative accessibility states.