atm

Atomix

v0.4.6

    1. Home
    2. Guides
    3. Devtools

Getting Started
  • Introduction
  • Installation
  • Quick Start
  • Migration Guide
  • CLI Reference
Design Tokens
  • Overview
  • All Tokens
  • Colors
  • Spacing
  • Typography
  • Grid
  • Elevation
Styles System
  • Architecture
  • Customization
  • Utilities
  • API Reference
Layouts
  • Grid System
  • Masonry Grid
  • Responsive Patterns
  • Customization
  • Performance
Components
  • Overview
  • Guidelines
  • Accordion
  • AtomixGlass
  • Avatar
  • Badge
  • Breadcrumb
  • Button
  • ButtonGroup
  • Card
  • Checkbox
  • Date Picker
  • Dropdown
  • Form
  • Input
  • Modal
  • Progress
  • Radio
  • Rating
  • Select
  • Slider
  • Spinner
  • Tab
  • Textarea
  • Toggle
  • Tooltip
  • Upload
  • Block
  • Callout
  • Countdown
  • Hero
  • Icon
  • List
  • Messages
  • Navbar
  • Pagination
  • Popover
  • Steps
  • SectionIntro
  • Container
  • Grid
  • GridCol
  • Row
  • River
  • MasonryGrid
  • DataTable
  • EdgePanel
  • SideMenu
  • Nav
  • NavItem
  • NavDropdown
  • VirtualizedGrid
Guides
  • Theming Guide
  • AtomixGlass Performance
  • AtomixGlass Theming
  • Theme Studio
  • Devtools
  • Theme Inspector
  • Theme Preview
  • Theme Comparator
  • Live Editor
  • CLI Tool
  • Try Live Editor
  • Try Inspector
  • Try Preview
  • Try Comparator
  • AtomixGlass Playground
Examples
  • Common Patterns
  • Landing Page
API Reference
  • React API
  • JavaScript API
  • CSS API
CLI
  • Overview
  • User Guide
  • API Reference
  • Migration Guide
  • Security Guide
Resources
  • Roadmap
  • Changelog
  • Contributing

Atomix Design System

A comprehensive design system for building modern, accessible, and performant web applications with React and vanilla JavaScript.
GitHubTwitterDiscordNPM

Getting Started

IntroductionInstallationQuick StartTheming Guide

Documentation

ComponentsDesign TokensStyles SystemLayouts

Resources

GitHub Repository↗NPM Package↗Storybook↗API Reference

Community

ContributingRoadmapChangelogReport Issue↗

© 2026 Atomix Design System. Built with ❤️ by the Shohojdhara.

Powerful development tools for theme creation and debugging

Atomix Devtools

A comprehensive suite of tools to inspect, preview, compare, and edit themes. Build better themes faster with real-time feedback and validation.

Development Tools Suite

Atomix provides a complete set of development tools to streamline theme creation, debugging, and testing. Whether you're building a new theme or debugging an existing one, these tools provide the insights you need.

Quick Start

Installation

BASH
npm install @shohojdhara/atomix
1 line31 characters

Import Devtools

TSX
import { ThemeInspector, ThemePreview, ThemeComparator, ThemeLiveEditor } from '@shohojdhara/atomix/theme/devtools';
6 lines128 characters

Available Tools

Theme Inspector

Deep inspection and validation of theme structure, CSS variables, and accessibility issues.

Learn more →

Theme Preview

Live preview of themes with sample components, color palettes, and typography scales.

Learn more →

Theme Comparator

Side-by-side comparison of two themes with difference highlighting and statistics.

Learn more →

Live Editor

Real-time theme editing with visual and JSON editors, instant preview, and export capabilities.

Learn more →

CLI Tool

Command-line interface for theme validation, inspection, comparison, and export.

Learn more →

Common Workflows

Creating a New Theme

  1. Use Live Editor to create and customize your theme visually
  2. Use Inspector to validate structure and check for issues
  3. Use Preview to test with sample components
  4. Export your theme and integrate into your project

Debugging Theme Issues

  1. Use Inspector to identify validation errors and warnings
  2. Check accessibility issues with contrast ratio analysis
  3. Review generated CSS variables for correctness
  4. Use Preview to visually verify fixes

Comparing Theme Versions

  1. Load both theme versions into Comparator
  2. Review differences and statistics dashboard
  3. Filter to show only changed values
  4. Document breaking changes for release notes

Integration Examples

Development Dashboard

Create a comprehensive theme development dashboard:

TSX
1import { 2 ThemeInspector, 3 ThemePreview, 4 ThemeComparator, 5 ThemeLiveEditor 6} from '@shohojdhara/atomix/theme/devtools'; 7import { createTheme } from '@shohojdhara/atomix/theme'; 8import { useState } from 'react'; 9 10function ThemeDashboard() { 11 const [currentTheme, setCurrentTheme] = useState( 12 createTheme({ 13 name: 'My Theme', 14 palette: { 15 primary: { main: '#7AFFD7' }, 16 }, 17 }) 18 ); 19 20 return ( 21 <div className="theme-dashboard"> 22 {/* Live Editor */} 23 <section> 24 <h2>Edit Theme</h2> 25 <ThemeLiveEditor 26 initialTheme={currentTheme} 27 onChange={setCurrentTheme} 28 /> 29 </section> 30 31 {/* Inspector */} 32 <section> 33 <h2>Inspect Theme</h2> 34 <ThemeInspector 35 theme={currentTheme} 36 showValidation={true} 37 showCSSVariables={true} 38 /> 39 </section> 40 41 {/* Preview */} 42 <section> 43 <h2>Preview Theme</h2> 44 <ThemePreview 45 theme={currentTheme} 46 showPalette={true} 47 showTypography={true} 48 /> 49 </section> 50 </div> 51 ); 52}
52 lines1117 characters

Storybook Integration

Add theme preview to your Storybook:

TSX
1// .storybook/preview.tsx 2import { ThemePreview } from '@shohojdhara/atomix/theme/devtools'; 3 4export const decorators = [ 5 (Story, context) => { 6 const theme = context.globals.theme; 7 8 return ( 9 <ThemePreview theme={theme}> 10 <Story /> 11 </ThemePreview> 12 ); 13 }, 14];
14 lines294 characters

Best Practices

Always Validate

Use ThemeInspector during development to catch issues early. Enable validation to check for accessibility problems, missing required properties, and invalid values.

Test with Real Components

Use ThemePreview with your actual components, not just the default samples. This ensures your theme works correctly in your specific use cases.

Compare Before Releasing

Always use ThemeComparator to review changes between theme versions before releasing updates. This helps identify breaking changes and unexpected modifications.

Performance Considerations

Devtools are designed for development environments. While they're optimized with memoization and debouncing, avoid using them in production builds.

Next Steps

Explore each devtools component in detail:

✨ Try Interactive Examples:

  • Live Editor — Create and edit themes in real-time
  • Inspector — Analyze and validate themes
  • Preview — Visualize themes with components
  • Comparator — Compare theme versions
→ Theme Inspector Documentation→ Theme Preview Documentation→ Theme Comparator Documentation→ Live Editor Documentation→ CLI Tool Documentation