reablocks icon indicating copy to clipboard operation
reablocks copied to clipboard

Unify DS tokens integration

Open evgenoid opened this issue 4 months ago • 8 comments

Button

Component changes:

  • Removed default, success, error and warning color types
  • Added destructive color type
  • Added ghost variant type
Screenshot 2025-07-30 at 16 04 07

Icon Button

Variants

Screenshot 2025-07-30 at 16 24 31

Colors

Screenshot 2025-07-30 at 16 23 41 Screenshot 2025-07-30 at 16 23 46 Screenshot 2025-07-30 at 16 23 51

Avatar

Screenshot 2025-07-30 at 17 39 22

Checkbox

Screenshot 2025-08-04 at 13 58 44

Dialog

Screenshot 2025-08-04 at 14 13 32

Input

Screenshot 2025-08-04 at 14 49 07

Textarea

Screenshot 2025-08-04 at 14 49 26

List

Screenshot 2025-08-04 at 14 54 03

###JSONTree Screenshot 2025-08-04 at 15 02 55

Menu

Screenshot 2025-08-04 at 15 29 37

Notification

Screenshot 2025-08-04 at 15 56 57

Radio

Screenshot 2025-08-04 at 16 10 12

Range

Screenshot 2025-08-05 at 09 18 46

Pager

Screenshot 2025-08-05 at 09 44 42

Select

Screenshot 2025-08-05 at 10 06 23

Tabs

Screenshot 2025-08-11 at 13 06 29

Toggle

Screenshot 2025-08-05 at 11 43 27

Tree

Screenshot 2025-08-05 at 11 46 33

Calendar

Screenshot 2025-08-05 at 14 22 39 Screenshot 2025-08-05 at 14 22 48 Screenshot 2025-08-05 at 14 22 54

Callout

Screenshot 2025-08-05 at 15 21 16

DateInput

Screenshot 2025-08-05 at 16 18 21

Kbd

Screenshot 2025-08-05 at 16 56 32

Stepper

Screenshot 2025-08-06 at 12 19 09 Screenshot 2025-08-06 at 12 19 18 Screenshot 2025-08-06 at 12 19 23

CommandPalette

Screenshot 2025-08-06 at 14 55 05

Chip

Screenshot 2025-08-07 at 11 01 44

evgenoid avatar Jul 29 '25 14:07 evgenoid

Deploy Preview for reablocks-storybook ready!

Name Link
Latest commit 11f68dfdeae82578af45afdad8a5b4bd29df274c
Latest deploy log https://app.netlify.com/projects/reablocks-storybook/deploys/69294724609ae400088c5c80
Deploy Preview https://deploy-preview-298--reablocks-storybook.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

netlify[bot] avatar Jul 29 '25 14:07 netlify[bot]

@evgenoid initial thoughts - part of the reason I was splitting out the theme files completely was because migrating to the upgraded version without all of the tokens in place is going to be a problem. it feels like we need a v2 version of the theme that we can pull if we're starting with the new design system, but the original themes shouldn't change so much. let me know if that makes sense.

steppy452 avatar Aug 12 '25 02:08 steppy452

@evgenoid initial thoughts - part of the reason I was splitting out the theme files completely was because migrating to the upgraded version without all of the tokens in place is going to be a problem. it feels like we need a v2 version of the theme that we can pull if we're starting with the new design system, but the original themes shouldn't change so much. let me know if that makes sense.

Do you propose keep old and new theme in parallel? Or I don't get it?

evgenoid avatar Aug 12 '25 07:08 evgenoid

@evgenoid initial thoughts - part of the reason I was splitting out the theme files completely was because migrating to the upgraded version without all of the tokens in place is going to be a problem. it feels like we need a v2 version of the theme that we can pull if we're starting with the new design system, but the original themes shouldn't change so much. let me know if that makes sense.

Do you propose keep old and new theme in parallel? Or I don't get it?

I think yea, we'll need a new theme in parallel unless you can think of an easy migration path

steppy452 avatar Aug 13 '25 06:08 steppy452

I think yea, we'll need a new theme in parallel unless you can think of an easy migration path

I don't think we need it in parallel. If end-user wants to keep it looks previously but update the version, it can be rewrited with old tokens and theme configuration.

@SerhiiTsybulskyi what do you think about it?

evgenoid avatar Aug 13 '25 06:08 evgenoid

I think yea, we'll need a new theme in parallel unless you can think of an easy migration path

I don't think we need it in parallel. If end-user wants to keep it looks previously but update the version, it can be rewrited with old tokens and theme configuration.

@SerhiiTsybulskyi what do you think about it?

I agree with @evgenoid. Old and new theme structure (interface) have changes that will increase the complication.

SerhiiTsybulskyi avatar Aug 13 '25 06:08 SerhiiTsybulskyi

@steppy452, before move forward we need to handle several core things because I see alot of repeateble comments:

  1. Tokens level. On a 4th level we don't have any component unrelated tokens but in the same time DS using tokens of the 3rd level for some borders, backgrounds and text colors. Tokens of 3rd level still themed and has two different colors for light and dark modes. If you are still thinking that we need to use only 4th level then need to ask design team add it to this level and update the DS. But additional problem that some components in Reablocks don't have reflection in DS (Divider, Card, Stepper and so on) and we don't have 4rd level token for it for this reason.

  2. Theme interface and tokens changing I believe we can provide in migration documentation old list of tokens and old theme object which users can add to project and continue use it if they don't want to spend time to adopt their project with new tokens.

  3. Some component theme changing I think it's fine that some default properties (like variant, color) were changed. We will provide these changes in migration documentation and users should be able safely update it.

Before release we will test our updates on several internal projects and will see how it works.

My initial thoughts, when we started work on new DS was full aligning it with Reablock library. I even see on Austin's screenshots that some client asking about components library related to our DS. But finally we want just adopt Reablocks to new DS with minimal blood.

cc: @SerhiiTsybulskyi @amcdnl

Example of using tokens of 3rd level in components: Screenshot 2025-08-15 at 11 28 07

evgenoid avatar Aug 15 '25 08:08 evgenoid

@steppy452, before move forward we need to handle several core things because I see alot of repeateble comments:

  1. Tokens level. On a 4th level we don't have any component unrelated tokens but in the same time DS using tokens of the 3rd level for some borders, backgrounds and text colors. Tokens of 3rd level still themed and has two different colors for light and dark modes. If you are still thinking that we need to use only 4th level then need to ask design team add it to this level and update the DS. But additional problem that some components in Reablocks don't have reflection in DS (Divider, Card, Stepper and so on) and we don't have 4rd level token for it for this reason.

Ahh I see what you mean. I was mistaken - I kept thinking 3rd level tokens were just a passthrough and not exported with the plugin. But it seems it is so this should be ok using 3rd level in some places 👍

  1. Theme interface and tokens changing I believe we can provide in migration documentation old list of tokens and old theme object which users can add to project and continue use it if they don't want to spend time to adopt their project with new tokens.
  1. Some component theme changing I think it's fine that some default properties (like variant, color) were changed. We will provide these changes in migration documentation and users should be able safely update it.

Before release we will test our updates on several internal projects and will see how it works.

sounds good - migration is one of the major pieces I worry about as we'll likely have to do this migration ourselves for a lot of our clients going forward. The more changes we make, the harder it will be for ourselves. but agree we can maybe do an alpha release and test on some internal projects first 👍

steppy452 avatar Aug 15 '25 17:08 steppy452