Skip to content

Comments

[docs] Add version badges#3978

Open
m-bert wants to merge 72 commits intomainfrom
@mbert/docs-badges-versions
Open

[docs] Add version badges#3978
m-bert wants to merge 72 commits intomainfrom
@mbert/docs-badges-versions

Conversation

@m-bert
Copy link
Contributor

@m-bert m-bert commented Feb 13, 2026

Description

This PR, similarly to #3975, adds badges for versions for the features.

Darkmode

image

Lightmode

image

Test plan

Read docs 🤓

@m-bert m-bert added the Documentation Documentation change/enhancement label Feb 16, 2026
Copy link
Member

@j-piasecki j-piasecki left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sold on the styling. I don't think the version badge should be that attention-grabbing.

<PlatformBadge key={platform} platform={platform} />
))}

{version && <VersionBadge version={version} />}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IMO, the version badge should come before the platform ones.

We can also go the Android way and have it always to the right

Image

We may also want to default to showing "3.0" if no version is provided to be consistent. So there's no ambiguity about which version something is available from.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sold on the styling. I don't think the version badge should be that attention-grabbing.

I agree. Android convention looks good, but do we want it as a plain text, or have it in a badge like platform, with with different color (like white badge with black text)?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Styles updated in 36b7fe0. I've also removed unused import from FlowChart (been there to steal useColorMode)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So if styling looks good, the question is where do we want to put them. Props like disableReanimated and so on? Or do we wait for something new.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So if styling looks good, the question is where do we want to put them. Props like disableReanimated and so on? Or do we wait for something new.

That's a good question - on one hand, I like the way Android does it, so everything is clearly labeled, but on the other, that's a lot of boxes. It could be ok if we reduce it only to the version instead of Available from ..., but it's not as clean then.

TL;DR: I don't know

@m-bert m-bert marked this pull request as ready for review February 17, 2026 14:20
},

badge: {
borderRadius: 10,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
borderRadius: 10,
borderRadius: 16,

IMO it looks nicer.

const styles = StyleSheet.create({
container: {
display: 'flex',
flexDirection: 'row',
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
flexDirection: 'row',
flexDirection: 'row',
flexWrap: 'wrap',

I think it looks nicer this way on narrow screens.
Image

vs

Image

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree. I also moved it to the left on smaller screens:

image

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

@j-piasecki j-piasecki left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. I forgot about it yesterday, but when I was checking it, I was experimenting with reducing the font size for the version badge (I think 12px). I'm fine with both, so I'll leave it up to you.
  2. Can you please merge this after the platform badges?

@m-bert
Copy link
Contributor Author

m-bert commented Feb 19, 2026

Can you please merge this after the platform badges?

Sure, that's my plan

I forgot about it yesterday, but when I was checking it, I was experimenting with reducing the font size for the version badge (I think 12px). I'm fine with both, so I'll leave it up to you.

12px looks way too small (at least when looking from distance):

image

But I guess your point is to reduce it. To be honest, I'd leave that as it is now.

Base automatically changed from @mbert/docs-badges to main February 19, 2026 12:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Documentation change/enhancement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants