Skip to content

rehan-devs/chromacraft-studio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎨 ChromaCraft Studio

A premium color system generator for designers and developers.

Generate complete, production-ready color systems from a single brand color β€” with perceptually uniform shade scales, color harmonies, accessibility audits, dark mode palettes, and multi-format export.

Live Demo β†’ Β· Report Bug β†’ Β· Request Feature β†’


React TypeScript Tailwind CSS Vite


✨ Features

  • 🎯 One Color In, Full System Out β€” Enter any color (HEX, RGB, or HSL) and instantly generate a complete design system
  • 🌈 Perceptually Uniform Shades β€” 11-step shade scale (50–950) using LAB/LCH color space interpolation, not naive lighten/darken
  • πŸ”„ Interactive Color Wheel β€” Drag to adjust hue in real-time with harmony colors visualized on the wheel
  • 🎭 Color Harmonies β€” Complementary, analogous, triadic, and split-complementary palettes with full shade scales
  • πŸŒ™ Dark Mode Generation β€” Complete semantic dark palette with a realistic UI mockup preview
  • β™Ώ Accessibility Audit β€” WCAG 2.1 contrast ratings for every shade against white and black text
  • ✏️ Live Text Preview β€” Test custom text with any foreground/background combination and adjustable font sizes
  • 🎨 Harmony Mixer β€” Side-by-side color pairing previews with contrast ratios
  • πŸ’Ύ Save & Load Palettes β€” Save unlimited palettes to local storage for later use
  • πŸ“¦ Multi-Format Export β€” CSS custom properties, Tailwind config, SCSS variables, and JSON with custom naming
  • πŸͺ„ Adaptive UI β€” The app's own accent color adapts to match your input color
  • πŸ“± Fully Responsive β€” Premium experience on desktop, tablet, and mobile

πŸ–ΌοΈ Preview

Enter a color and watch your complete design system come to life.

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm, yarn, or pnpm

Installation

# Clone the repository
git clone https://github.com/rehan-devs/chromacraft-studio.git
cd chromacraft-studio

# Install dependencies
npm install

# Start development server
npm run dev
The app will be running at http://localhost:5173

πŸ“¦ Build for Production

# Create optimized production build
npm run build

# Preview production build locally
npm run preview

The dist/ folder will contain your production-ready static files.


πŸ› οΈ Tech Stack

Technology Purpose
React 18 UI framework with functional components and hooks.
TypeScript Type safety in strict mode.
Vite Build tool & dev server
Tailwind CSS Utility-first styling
Chroma.js Color scienceβ€”LAB/LCH interpolation, contrast ratios.
React Router v6 Client-side routing
Lucide React Icon system.
Framer Motion Spring-physics animations and micro-interactions.
Zero UI library dependencies Every component is custom-built.

πŸ“‚ Project Structure

src/
β”œβ”€β”€ App.tsx                  # Root application component
β”œβ”€β”€ main.tsx                 # Entry point
β”œβ”€β”€ index.css                # Global styles, fonts, grain texture
β”œβ”€β”€ types/
β”‚   └── index.ts             # TypeScript interfaces
β”œβ”€β”€ hooks/
β”‚   β”œβ”€β”€ useColorEngine.ts    # Core color system generation
β”‚   β”œβ”€β”€ useSavedPalettes.ts  # localStorage palette management
β”‚   └── useClipboard.ts      # Clipboard API wrapper
β”œβ”€β”€ utils/
β”‚   β”œβ”€β”€ colorGenerator.ts    # Shade scales, harmonies, dark mode
β”‚   β”œβ”€β”€ contrastChecker.ts   # WCAG contrast calculations
β”‚   β”œβ”€β”€ exporters.ts         # CSS, Tailwind, SCSS, JSON export
β”‚   └── colorParser.ts       # Multi-format color input parsing
└── components/
    β”œβ”€β”€ Layout/              # Header, Footer
    β”œβ”€β”€ Input/               # Color input, format toggle, color wheel
    β”œβ”€β”€ Palette/             # Shade scale, harmonies, dark mode
    β”œβ”€β”€ Accessibility/       # Contrast grid, live preview
    β”œβ”€β”€ Export/              # Multi-format code export
    β”œβ”€β”€ SavedPalettes/       # Palette library drawer
    └── Common/              # Toast, copy button, section title, grain

🎨 Color Science

ChromaCraft Studio uses perceptually uniform color spaces for all color math:

  • Shade generation interpolates in LAB space between warm white (#FFFEF9) and warm black (#121210)
  • Light tints are subtly desaturated for a natural feel
  • Dark shades shift hue slightly toward blue, mimicking natural shadow behavior
  • Dark mode palettes are generated using LCH color space for precise lightness and chroma control
  • Contrast ratios follow WCAG 2.1 guidelines with AAA/AA/AA Large/Fail ratings

🎨 πŸ”‘ What Makes This Different

  • Feature Typical Tools ChromaCraft Studio
  • Color interpolation HSL (perceptually uneven) LAB/LCH (perceptually uniform)
  • Dark mode Manual or none Auto-generated semantic palette with UI preview
  • Accessibility Basic or separate tool Integrated audit with live text preview
  • Color wheel Static display Interactive, draggable with harmony visualization
  • Export Single format CSS, Tailwind, SCSS, JSON with custom naming
  • App feel Generic dashboard Editorial design tool with grain texture & micro-interactions

🎨 πŸ—ΊοΈ Roadmap

  • Color Blindness Simulation β€” Preview palettes as seen by colorblind users
  • Figma Plugin β€” Export directly to Figma variables
  • VS Code Extension β€” Generate palettes without leaving your editor
  • AI Color Naming β€” Intelligent, memorable names for your shades
  • Brand Guidelines Export β€” Generate PDF documentation
  • Team Collaboration β€” Share and sync palettes across teams
  • Color Trend Analysis β€” Suggestions based on current design trends

🎨 🀝 Contributing

Contributions are welcome! Feel free to:

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

🎨 πŸ“§ Contact

Created by Rehan β€” GitHub | Website

⭐ If you find this useful, please star the repo!


🎨 πŸ“„ License

This project is open source and available under the MIT License.


Craft color systems with intention. Built with ❀️ for designers who care about craft.

About

🎨 A premium color system generator. Enter one brand color β†’ get a complete design system with perceptually uniform shade scales, color harmonies, dark mode palettes, WCAG accessibility audits, and production-ready export in CSS/Tailwind/SCSS/JSON. Built with React, TypeScript, Tailwind CSS, and Chroma.js.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages