Skip to content

Commit c66a413

Browse files
authored
Add blog post about colors (#167)
* Add blog post about colors * Fix broken URL and truncate blog post for blog list page * Remove duplicated text * Remove redundant embedded machine * Add more links, alt text, and machine names * Fix broken link
1 parent f158a53 commit c66a413

File tree

6 files changed

+95
-0
lines changed

6 files changed

+95
-0
lines changed
Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
---
2+
title: 'Improving your flows with color'
3+
description: Join Anders and Laura for a tour of Stately Studio and an introduction to state machines featuring the next release of Stately Studio.
4+
tags: [stately studio, state machines, color, pro features]
5+
authors: [laura]
6+
slug: 2023-07-24-improving-your-flows-with-color
7+
image: /blog/2023-07-24-improving-your-flows-with-color.png
8+
date: 2023-07-24
9+
---
10+
11+
As part of our recent colossal release, we’ve launched a new feature for pro users - [colors](/docs/colors). With this feature, you can add a layer of visual distinction to your statecharts, making them more organized, informative, and accessible for your team to understand.
12+
13+
<p>
14+
<ThemedImage
15+
alt="State machine showing how to choose colors from the color palette, and the colors for default (grey in darkmode, white in lightmode), pink, purple, red, orange, yellow, green, and blue states and transitions."
16+
sources={{
17+
light: '/blog/2023-07-24-improving-your-flows-with-color/choosing-colors.png',
18+
dark: '/blog/2023-07-24-improving-your-flows-with-color/choosing-colors-dm.png',
19+
}}
20+
/>
21+
</p>
22+
23+
<!-- truncate -->
24+
25+
## How can I use colors in Stately?
26+
27+
You can assign colors from the palette menu to different states and transitions in your flows. You can choose from various color options, including pink, purple, red, orange, yellow, green, and blue. You can also reset a state or transition back to the default color; gray in dark mode and white in light mode.
28+
29+
## Why use colors?
30+
31+
Many folks requested colors for their state machines, not just because colors make everything prettier! The bigger a machine gets, the more you want to distinguish or draw attention to particular states or transitions.
32+
33+
### Color coding groups or types of states or events
34+
35+
One common use is to connect color to a meaning, such as making error states red and success states green. You could set transition colors to identify a common target, shared source, or group states and transitions meaningfully for your team.
36+
37+
<EmbedMachine name="Editor page machine" embedURL="https://stately.ai/registry/editor/embed/7b5d60dc-94b0-4a1e-9ade-ea644b8cc35f?machineId=8b2c257c-2060-45a5-bdb1-e91b7f5c9318" />
38+
39+
The machine above uses yellow for user events, purple for system events, and red for errors.
40+
41+
### Organize flows into regions with distinct colors
42+
43+
Some other ways to use color are to use different colors to highlight different user personas or stories or mark popular paths through your app based on usage data.
44+
45+
<EmbedMachine name="" embedURL="https://stately.ai/registry/editor/embed/7b5d60dc-94b0-4a1e-9ade-ea644b8cc35f?machineId=35d9c021-9b00-4c6f-85c9-1f2fece5d0c5" />
46+
47+
### Use color for fun!
48+
49+
Or maybe you want to use color for fun. You can use color to decorate your flows to fit your brand or decorate your states and transitions.
50+
51+
<EmbedMachine name="Traffic light machine" embedURL="https://stately.ai/registry/editor/embed/7b5d60dc-94b0-4a1e-9ade-ea644b8cc35f?machineId=e35f9079-722e-4812-8103-e63ada46456f" />
52+
53+
## How to use colors in your flows
54+
55+
Read more about [adding colors](/docs/colors) and [upgrading to a Pro account](/docs/upgrade) in our docs.
56+
57+
If you want to explain your color coding, we’ve had success using an annotation box as a key to help others understand the meaning behind each color.
58+
59+
<p>
60+
<ThemedImage
61+
alt="State machine with red, yellow, and purple transitions, and an annotation containing a key with yellow for user events, purple for system events and red for errors."
62+
sources={{
63+
light: '/blog/2023-07-24-improving-your-flows-with-color/color-key.png',
64+
dark: '/blog/2023-07-24-improving-your-flows-with-color/color-key-dm.png',
65+
}}
66+
/>
67+
</p>
68+
69+
70+
When using colors to convey information, it is essential to keep accessibility in mind. Not everyone perceives color the same way, and as many as 8% of men and 0.5% of women are color blind. Ensure your statecharts are inclusive by using color to emphasize or decorate your machines, and [do not use color as the only way to convey information](https://www.w3.org/WAI/WCAG21/Understanding/use-of-color.html).
71+
72+
To make your colored machines more accessible, add the color or symbolic name as a tag on your states and transitions, or include them in their descriptions.
73+
74+
<EmbedMachine name="Expense machine" embedURL="https://stately.ai/registry/editor/embed/7b5d60dc-94b0-4a1e-9ade-ea644b8cc35f?machineId=9a62b8b1-b5a3-4b15-a5ed-acfe5f65da80" />
75+
76+
Colors are a powerful feature that helps you improve your statecharts' organization, clarity, and user-friendliness. To learn more about using Colors, check out our [documentation](/docs/colors).
77+
78+
## More Pro features
79+
80+
Colors is one of many Pro features we've recently added to Stately. Our current Pro features include:
81+
82+
- [Teams and shared projects](/docs/teams)
83+
- [Private and unlisted projects](/docs/projects#change-a-projects-visibility)
84+
- [Version history](/docs/versions)
85+
- [Import from GitHub](/docs/import-from-github)
86+
- [Live simulation mode](/docs/live-simulation)
87+
- [Color states and transitions](/docs/colors)
88+
- [Priority support](/docs/studio-pro-plan#priority-support)
89+
- GitHub Sync (coming soon!)
90+
- Workflows (coming soon!)
91+
- Live collaboration (coming soon!)
92+
93+
And we've got many more coming soon! Want to suggest a feature? Leave a feature request on our feedback board or upvote other features we should prioritize.
94+
95+
Want to try the Pro plan? You can get a 30-day free trial when you [join from our website](/pricing) or [upgrade](/docs/upgrade) from [the editor](https://state.new).
286 KB
Loading
167 KB
Loading
200 KB
Loading
184 KB
Loading
218 KB
Loading

0 commit comments

Comments
 (0)