Skip to content

Commit b743392

Browse files
feat: Complete UI redesign with improved gradient controls and workflow
Major Updates: - Redesigned 2-column grid layout matching mockup specifications - Added visual slider knobs for angle and position controls - Implemented RGB/HSL color mode toggle - Added visible color picker for gradient stops - Integrated base color selection with preset gradient styles (Smooth, Glossy, Vibrant, Subtle) - Added +/- buttons for adding/removing gradient stops - Replaced default icons with popular coding frameworks (React, Angular, Vue, etc.) - Fixed icon selection to properly update preview and state - Improved gradient generation for grayscale colors (black/white) Design System: - Complete CSS overhaul with new visual design from layout.html - Glass morphism cards with grain overlay and vignette effects - Stream Deck device illustration in hero header - Improved color indicators and stop management UI Bug Fixes: - Fixed icon switching not updating preview - Fixed gradient color mode defaulting to RGB on load - Fixed grayscale gradient generation for very dark/light colors - Improved slider knob positioning and synchronization Documentation: - Added development status disclaimer - Updated README with comprehensive usage instructions - Added bug reporting guidelines - Documented all new features and controls
1 parent 0ac195c commit b743392

6 files changed

Lines changed: 1065 additions & 698 deletions

File tree

README.md

Lines changed: 60 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Stream Deck Icon Generator
22

3+
> ⚠️ **DEVELOPMENT STATUS**: This project is currently under active development. Features are being implemented and bugs are being fixed. Please report any issues you encounter on the [Issues page](https://github.com/SyntaxSidekick/Stream-Deck-Icon-Generator/issues).
4+
35
A powerful web-based tool for creating custom Stream Deck icons with gradient backgrounds. Generate professional-looking icons by combining FontAwesome SVG graphics with customizable gradient overlays, all exportable as PNG files in multiple sizes.
46

57
## Features
@@ -11,10 +13,14 @@ A powerful web-based tool for creating custom Stream Deck icons with gradient ba
1113
-**SVG Caching** - Intelligent caching system for 90% faster loading
1214

1315
### Gradient Customization
14-
-**Linear & Radial Gradients** - Switch between gradient types
16+
-**Linear & Radial Gradients** - Switch between gradient types with visual toggle
1517
-**Multi-stop Gradients** - Add, remove, and position unlimited color stops
1618
-**Interactive Gradient Bar** - Drag color stops directly on the preview bar
17-
-**Gradient Randomizer** - Generate random gradients with optional base color
19+
-**Color Mode Toggle** - Switch between RGB and HSL color modes
20+
-**Visual Slider Controls** - Draggable knobs for angle and position adjustments
21+
-**Stop Indicators** - Visual color swatches showing all gradient stops
22+
-**Gradient Randomizer** - Generate random gradients instantly
23+
-**Base Color Selection** - Choose a base color for gradient generation
1824
-**Preset Styles** - Choose from Smooth, Glossy, Vibrant, and Subtle gradient styles
1925
-**Color-Aware Generation** - Create grayscale or same-hue gradients based on base color
2026

@@ -81,21 +87,29 @@ http://localhost:3000
8187
### Basic Workflow
8288

8389
1. **Select an Icon**
84-
- Click "Choose Icon" to open the icon picker
90+
- Click on one of the preset framework icons (React, Angular, Vue, Python, etc.)
91+
- Or click the "+" button to open the full icon picker
8592
- Search for icons by name (e.g., "github", "twitter", "gaming")
8693
- Click an icon to select it
8794

8895
2. **Customize the Gradient**
89-
- Choose between Linear or Radial gradient types
90-
- Drag color stops on the gradient bar to reposition them
91-
- Click stops to change their colors
92-
- Add or remove stops using the buttons
93-
- Apply preset gradient styles (Smooth, Glossy, Vibrant, Subtle)
96+
- **Choose Base Color**: Select a base color using the color picker
97+
- **Apply Preset Style**: Click Smooth, Glossy, Vibrant, or Subtle to generate a gradient based on your base color
98+
- **Switch Gradient Type**: Toggle between Linear and Radial gradients
99+
- **Adjust Angle**: For linear gradients, drag the angle slider (0-360°)
100+
- **Modify Color Stops**:
101+
- Click on a stop indicator to make it active
102+
- Use the color picker to change the active stop's color
103+
- Drag the position slider to reposition the stop (0-100%)
104+
- Click "+" to add a new stop
105+
- Click "−" to remove the active stop (minimum 2 stops required)
106+
- **Toggle Color Mode**: Switch between RGB and HSL modes
107+
- **Randomize**: Click "Randomize" for instant random gradients
94108

95109
3. **Adjust Icon Settings**
96-
- Set icon color using the color picker
97-
- Adjust icon size (20-80%)
98-
- Fine-tune vertical offset (-30% to +30%)
110+
- Set icon color using the color picker (default: white)
111+
- Adjust icon size using the slider (20-80%)
112+
- Fine-tune vertical offset with the slider (-30% to +30%)
99113

100114
4. **Export Your Icon**
101115
- Choose export size (72, 144, or 256 pixels)
@@ -107,16 +121,24 @@ http://localhost:3000
107121
### Gradient Randomizer
108122

109123
1. **Basic Randomization:**
110-
- Click "Randomize Gradient" to generate a random gradient
111-
112-
2. **Color-Based Randomization:**
113-
- Select a base color in the "Random base color" picker
114-
- Click "Randomize Gradient" to generate variations based on that color
115-
- For grayscale base colors (low saturation), generates grayscale gradients
116-
- For colorful base colors, generates same-hue gradients with varying lightness
117-
118-
3. **Clear Base Color:**
119-
- Click the "×" button to return to fully random gradients
124+
- Click "Randomize" button to generate a completely random gradient
125+
- Random type (linear or radial), angle, number of stops, and colors
126+
127+
2. **Base Color Gradients:**
128+
- Select a base color using the "Base Color" picker
129+
- Click a preset style button (Smooth, Glossy, Vibrant, or Subtle)
130+
- For grayscale colors (black, white, gray), generates smooth grayscale gradients
131+
- For vibrant colors, generates same-hue gradients with varying lightness and saturation
132+
- **Smooth**: 2-stop simple gradients
133+
- **Glossy**: 3-4 stops with highlights for a glossy effect
134+
- **Vibrant**: High saturation color bursts
135+
- **Subtle**: Low saturation, gentle transitions
136+
137+
3. **Manual Control:**
138+
- Click any gradient stop indicator to select it
139+
- Use the visible color picker to change the stop color to any value
140+
- Drag the position slider or the stop itself on the gradient bar
141+
- Add or remove stops as needed for complete control
120142

121143
### Preset Management
122144

@@ -318,13 +340,26 @@ This project is open source and available under the [MIT License](LICENSE).
318340
- **FontAwesome** - Icon library provider
319341
- **Stream Deck** - Inspiration for icon dimensions and use case
320342

321-
## Support
343+
## Support & Bug Reports
322344

323345
If you encounter any issues or have questions:
324346

325-
1. Check the [Issues](https://github.com/SyntaxSidekick/Stream-Deck-Icon-Generator/issues) page
326-
2. Open a new issue with detailed information
327-
3. Include browser version, OS, and steps to reproduce
347+
1. **Check Existing Issues**: Browse the [Issues page](https://github.com/SyntaxSidekick/Stream-Deck-Icon-Generator/issues) to see if your problem has been reported
348+
2. **Report a Bug**: Open a new issue with:
349+
- Clear description of the problem
350+
- Steps to reproduce
351+
- Expected vs actual behavior
352+
- Browser version and OS
353+
- Screenshots if applicable
354+
3. **Feature Requests**: Suggest new features or improvements via GitHub Issues
355+
4. **Questions**: Ask questions in the Discussions section
356+
357+
**Current Known Issues:**
358+
- Some gradient presets may not save correctly
359+
- File System Access API limited in Firefox/Safari (falls back to download)
360+
- Mobile touch interactions need refinement
361+
362+
Your feedback helps improve this tool for everyone!
328363

329364
## Roadmap
330365

0 commit comments

Comments
 (0)