Skip to content

docs: state the browser-support baseline + browserslist#108

Merged
lifeiscontent merged 3 commits into
mainfrom
docs/browser-support
Jun 17, 2026
Merged

docs: state the browser-support baseline + browserslist#108
lifeiscontent merged 3 commits into
mainfrom
docs/browser-support

Conversation

@lifeiscontent

Copy link
Copy Markdown
Collaborator

propel declared its browser support nowhere, even though its color tokens use oklch() and color-mix() and it builds on Tailwind v4 — each of which sets a hard floor a consumer can hit.

Using MDN's Browser Compatibility Data, the binding constraints are:

Feature Chrome/Edge Firefox Safari/iOS
oklch() (base tokens) 111 113 15.4
color-mix() (alpha/tint tokens) 111 113 16.2
Tailwind v4 floor 111 128 16.4
effective baseline 111 128 16.4

No IE. So this adds:

  • a Browser support table in the README, with the reason (older Safari 16.0–16.3 / Firefox < 128 render the tokens incorrectly)
  • a matching browserslist in package.json, so propel's own build tooling targets the same set

No CSS changes: the tokens use the plain oklch() / two-color color-mix(in oklch, ...) forms, not the relative (oklch(from ...)) or variadic syntaxes that carry partial-support caveats. Verified with vp check.

Copilot AI review requested due to automatic review settings June 16, 2026 14:07
@github-actions

github-actions Bot commented Jun 16, 2026

Copy link
Copy Markdown

📚 Storybook preview: https://pr-108-propel-storybook.vamsi-906.workers.dev

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

This PR documents @plane/propel’s minimum supported browser baseline (driven by Tailwind v4 and modern color token features) and aligns the package’s build targeting via a browserslist entry.

Changes:

  • Add a “Browser support” section to the package README, including a minimum-version table and rationale.
  • Add a browserslist field to packages/propel/package.json to codify the same baseline for tooling.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
packages/propel/README.md Adds documented browser-support baseline and rationale for unsupported versions.
packages/propel/package.json Adds browserslist to align build/tooling targets with the documented baseline.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread packages/propel/README.md Outdated
Comment thread packages/propel/README.md Outdated
Comment thread packages/propel/package.json
propel never declared which browsers it targets, yet its color tokens use
`oklch()` and `color-mix()` and it's built on Tailwind v4 — all of which set a
hard floor. Per MDN's compat data the binding constraints are Tailwind v4
(Safari 16.4, Firefox 128) and `color-mix()` (Safari 16.2), so the effective
baseline is Chrome/Edge 111+, Firefox 128+, Safari/iOS 16.4+, no IE.

Add a "Browser support" table to the README so consumers know what they get
(older Safari/Firefox render the tokens incorrectly), and a matching
`browserslist` so propel's own build tooling targets the same set.

The tokens use the plain, well-supported forms (literal `oklch()`, two-color
`color-mix(in oklch, ...)`), not the relative/variadic syntaxes that have
partial support, so nothing in the CSS needed changing.
Copilot AI review requested due to automatic review settings June 17, 2026 06:34
@lifeiscontent lifeiscontent force-pushed the docs/browser-support branch from 4bbbfa1 to 52bb465 Compare June 17, 2026 06:34

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

Comment thread packages/propel/README.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings June 17, 2026 06:36
@lifeiscontent lifeiscontent merged commit 046f844 into main Jun 17, 2026
3 checks passed
@lifeiscontent lifeiscontent deleted the docs/browser-support branch June 17, 2026 06:37

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants